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Welcome to the seventh year of QL 
Today. Perhaps | should quote a Star- 
date after the Clocking In article in the 
last issue, but I'll leave matters of time 
to our expert contributor! 


The Q60 goes from strength to strength. 
D&D Systems have told me that inter- 
est in the Q60 is high and they are well 
pleased. Who are these guys? We show 
you in this issue! Just before this issue 
went to press, Peter Graf confirmed to 
me that the Q40 is no more, it has been 
discontinued in favour of the Q4Oi (the 
improved Q40) and Q60. "The Q40 is 
dead, long live the Q40i 


| have had a Q60 on loan from D&D 
Systems for a little while now and | can 
tell you | am well pleased with it so far 
Because we are now in the busiest of 
periods with a major installation on at 
work and working long hours as a re- 
sult, | haven't managed to use it enough 
to warrant writing a review yet, but 
believe me from what I've seen so far, 
this is the most amazing QL system 
yet! The speed is breathtaking. The 
sheer number of things you can do 
with it is amazing. The 3 speaker 
sound system is amazing, the 20kHz 
sound system is worth the experience 
_ especially when you have been used 
to a QL BEEP! The price might seem 
steep at first due to the fairly low 
volume of manufacture, but believe me 
with this system you get what you pay 
for Provided that the machine proves 
reliable long term and after sales 
support is adequate this machine just 
can't go wrong! 


lt may well have a Desktop or two in 
the near future as well. Jim Hunkins is 
still working very hard on QDT and has 
sent us a progress report, while | have 
been working on a less ambitious one 
called Launchpad which although will 
run on a Q60, Is really designed more 
for QDOS users. | demonstrated it at 
the recent Quanta AGM and this chap 
came along and took an interest in it - 
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Dilwyn Jones 


| didn't realise | was talking to Claus 
'Q60' Graf as | had never met him be- 
fore! 


Quanta's recent annual general meeting 
revealed a few changes. John Gilpin, 
who has been closely associated with 
the North East Manchester QL group 
for some time and has been Quanta 
Head Librarian will also take on the 
membership secretary and treasurer 
roles after Bill Newell and John Taylor 
have stood down after many years of 
loyal service to the user group. And 
Bruce Nicholls will step into Colin Bas- 
kett's shoes as editor 


Finally, nice to see that despite being 
away from home for long periods with 
his work, Thierry Godefroy has managed 
to get his QDOS/SMS Repository of 
QL software back on line after his site 
vanished from the original page. 
Luckily, Phoebus Dokos had managed 
to archive a copy of the Repository 
and put up a temporary copy on his 
site. This was probably the largest 
single online QL software source and 
it's nice to see it back, Thierry! 


The Mice | 


‘Poor Eric. He got 
run down by a 
trackball on the 

» information 
superhighway’ 


“ee 
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uUooWeD 


Lear PCB-CAD V6.04 

Malcolm Lear has upgraded his PCBCad program 
to version 6.04, which contains the following 
changes. 

Saved states added to art file format. This extra 
data will simply be ignored by earlier versions. 
The saved states include NC drill information, 
thus making the separate drill file redundant. 
Added PCB. prefix to all extensions. Colour 
schemes added, toggled by F9. 

The program may be downloaded from my Other 
Software Page and is also available from my PD 
library service. 
http://www.soft.net.uk/dj/software/other/other.html 


PQIV Update — Claus Graf 

| have finished a new version of PQIV (Q40 

graphics program). The new features of v0.2 are: 

- Printing to PostScript files 

- Printer Dialog, size and position of image on 
paper can be adjusted with the mouse 

— Rotation of images 

Downloads at http://www.q40.de 


Changes at Quanta 

Bruce Nicholls will be producing the Quanta Ma- 
gazine from the June Issue. 

The magazine will now be electronically submit- 
ted to the printers, if you have adverts that need 
to be placed in the next issue please forward 
them on to Bruce either to his postal address 
given below or electronically to this email 
address (most QL/PC formats accepted). 

Any news/reviews/articles for the next issue 
please also send to this email address: 
editor@quanta.org.uk 

Bruce Nicholls 

Quanta Editor 

38 Derham Gardens 

Upminster 

Essex 

RM1i4 3HA 

UK 


At the Quanta AGM in Manchester, John Gilpin 
was appointed as Quanta Treasurer and 
Membership Secretary in addition to his existing 
post as Head Librarian. Email addresses are now 
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established as follows: 

quanta_librarian@uk2.net 

quanta_treasurer@uk2.net 
quanta_membership@uk2.net 

as well as his home address: gilpins@ic24.net 

The retiring officers (John Taylor and Bill Newell) 
have also offered to pass any messages to him 
during the take-over period) These changes 
should be made in the Quanta Magazine from the 
next issue. 


Bruce Nicholls (left picture). Former membership se- 
cretary Bill Newell (left) and John Gilpin (right picture). 


QDOS/SMS Repository 

Thierry Godefroy 

Because of some problems with my ISP the 
QDOS/SMS repository has been shut down two 
months ago. As | could not sort out these pro- 
blems, | had to setup a new web site (but | will 
change it again soon so as to get enough room 
for the whole 90Mb software archive). For the 
time being, the repository Is available at: 
http://www.multimania.com/godefroy/ 

Most links are in fact pointing to Phoebus R. 
Dokos' mirror (many thanks Phoebus for setting 
it up!), but the newest software | have received is 
now back locally as well... 

As my sparse free time will permit, | will even- 
tually get everything up and running again (an 
overdue update to my main QDOS/SMS site is 
also to come ‘soon’).. Please be patient, every- 


site is an annex to The QDOS/SMS support site, It helds almost all of the free software © 
available for QDOS/SMS systems (90 Mb of compressed data !). The philosophy of this repositary 
is not to hold all versions of all software ever written for QDOS/SMS systems, but rather to hold 
only the most up to date and/or most reliable version(s) of each given software. Please write nie if 
you find some outdated software and/or if you don't find a software that you think should be © 
there... 


Enjoy this site and... QDOS/SMS forever ! 
Thierry Godefroy. 


NEW; altarnate software classification (courtessy of Tim Swenson) 


The: menu: a 


ie: EE ieee EES 


The QDOS/SMS Repository Home Page 
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QL/E CD 
Urs Koenig has released the QL/E CD. This is a 
CD-ROM containing a revised QL PD/CDR distri- 
bution which includes some 600MB of software 
in a QXLWIN format, pre-configured QL/E Boot 
Partition with the QTOP/E distribution from coWo 
Electronic, recent demo versions of various QL 
emulators and the free emulators such as QLay. 
The QL/E CD costs 20 Euros or 10 pounds direct 
from 

Urs Koenig 

Munsterstrasse 4 

CH-6210 Sursee 

Switzerland. 

For further information, send an email to 
cowo@bluewin.ch or visit Urs's web page on 
http://mypage.bluewin.ch/QLvsJaguar/QL18.html 


The QL/E CD 


QEYBOARD 

With the current scarcity of QL keyboard mem- 
branes, it is heartening to hear that Dave Park 
(currently based in America, known as “Dexter” to 
those on the QL-Users mailing list) has been 
developing a new QL keyboard system called 
Qeyboard. He submitted a progress report to the 
mailing list as follows: 

"| have half the PCB material, the microswitches, 
half the headers, ribbon cable and the diodes 
for the Aurora version. | also have the design 
completed. I'm waiting on half the headers, IDC 
connectors, assorted hardware (spacers, 
screws) and some PCB materials. | have 
decided that yes, | will definitely auction the first 
one on Ebay.” 

This update was dated 30th April, obviously more 
progress will have been made by the time you 
read this. With luck, Dave will have either proto- 
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types or completed units by the time of the USA 
QL show in June. No news on prices etc yet. 

We wish him well with this project. The current 
lack of availability of QL keyboard membranes 
should help to ensure the success of this project. 


CD-ROM Readers 

The release of Thierry Godefroy’s Atapi/CD 
driver has also spawned the release of other 
related utilities from several authors. Intended to 
provide access to Atapi devices and general 
access to CD-ROMs on suitably equipped sys- 
tems (e.g. Qubide), on some devices even audio 
CDs can be played. And with some of the pro- 
grams on this CD, even systems not normally 
able to access the QXLWIN media preferred by 
most SMSQ systems. Any of these programs 
may be considered useful in their own right, to- 
gether | am of the opinion that they form a really 
useful package. 

Given the fact that several individuals on the QL 
scene (Phoebus Dokos, Urs Koenig, Gerard 
Plavec and myself for example) have released 
CD-ROMs for use with QL emulators such as 
QPC2, this means that potentially many more 
users can now make use of these CD-ROMs 
now that Qubide systems for example can ac- 
cess these devices. So, | have ensured that all of 
the following packages are available from my PD 
library service on 2 DD disks or 1 HD disk, library 
disk number GE53. The price for copying this 
package is £1 per disk, including supplying the 
media. 

GE53 includes Atapi and CD-ROM system exten- 
sions by Thierry Godefroy, needed to run the 
other packages mentioned. QXLWIN copier for 
Q40/Q60 by Wolfgang Lenerz. Allows you to 
copy files from a QXLWIN file held on CD-ROM 
on a Q40/Q60 using Thierry Godefroy's CD- 
ROM driver extensions above. Qwirc by Per Wit- 
te. QL Winchester Information And Rename Con- 
sole. QCDEZE. Duncan Neithercutt's GUI front 
end which enables browsing of any |SO-9660 
formatted CD-ROM from a Q40 or other QL 
system compatible with Thierry Godefroy’s ATAPI 
CD_ROM drivers (above) when these are in- 
Stalled. 


QCD_EZE pictured running on a Q40 


QBOX-USA 

John Impellizzeri reports that sadly he has been 
forced to close down QBOX-USA. The long run- 
ning QL bulletin board system has become a 
victim of equioment failure, rising line costs and 
reduced useage. 

John reckons that the reduced useage is proba- 
bly due to more and more use being made of the 
world wide web and less of dedicated bulletin 
board systems and partly to not having enough 
time to allow it to be kept as up to date as it 
used to be. QBOX-USA was started in Septem- 
ber 1993, and was heavily used in the mid 1990s, 
one of the few dedicated QL BBSes in America. 
John says: "| have no regrets running it as long 
as we did but | think its time has come and gone.” 


QL Documentation CD-ROM 
Conceived the evening before the Quanta AGM 
in Manchester this year and actually on sale at 
that workshop the following day, the QL Docu- 
mentation CD is a project by Darren Branagh and 
Dilwyn Jones to bring together as much of the 
publically available QL documentation as possible 
into. one collection. Priced at just £5 (plus 
postage), it is also freely copyable. Documents 
supplied include a copy of the QL Manual in plain 
text format, various printer control code listing 
documents, hotkeys, pointer environment and 
operating system documentation, plus various 
magazine articles and many reference docu- 
ments. If anyone has any such material to contri- 
bute to this work, please send files to Darren or 
Dilwyn, preferably by email or on floppy disk {to 
reduce the risk of error while retyping or scan- 
ning paper documents}. 


A collection of all the available GL 
Doosumentation in electronic format! 


LT COP UTING 


A QXL.AWIN CD from Dilyeyn Jones and 
Q-cetT 


QL Documentation CD 


News from George Gwilt 

The programs for which | am responsible are 
now on the SQLUG website at 
www.jms1.supanet.com 

(the site is maintained by John M. Sadler) 
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These programs now include CPTR, which is a 
new system for programming PE (pointer environ- 
ment) via C68. This differs from the ‘official’ one 
produced by Tony Tebby. 

The total of the zipped files amounts to around 1 
1/2 million bytes. 

Almost all the programs have been altered 
recently. Also the source files are now available. 
Although the set of Turbo programs is my res- 
ponsibility that of maintaining the manuals is Tim 
Swenson’s and the Turbo TK code, Dave Gil- 
ham's. This means that these parts of Turbo are 
not on the SQLUG site. 


QCOLOUR and QWIRC 

Wolfgang Uhlig’s QcoLour software is now avai- 
lable from the Other Software Page on my web- 
site. This is a programming aid to help you calcu- 
late colour numbers using on screen sliders to 
adjust colours. This is a program strictly for the 
“colour drivers’ (GD2 Graphics Driver in SMSQ/E), 
which (to quote Roy Wood) "gives you a splash 
of colour” on your computer QcoLour also intro- 
duces colour “skins” to QL programs for the first 
time, | believe. 

Also, on the same page, Per Witte’s Qwirc soft- 
ware IS now at version 0.47. 

Both programs will also be available from DJ's PD 
library service if you prefer to obtain the software 
on disk ~ QcoLour needs either 2xDSDD disks 
or 1xHD disk. 


TURBO Compiler 

Turbo Compiler version 4 release 15 (v4.15) from 
George Gwilt is now on the Other Software Page 
on my website. 

This corrects a problem in the use of TO with 
CON/SCR channels. 
http://www.soft.net.uk/dj/software/other/other.html 

or from the SQLUG website as mentioned above. 


Mark Knight Website 

QL software author Mark Knight has now set up 
his own web site for his QL software and his 
work on computer graphics generally. Visit it on: 
http://www.the-furnace.demon.co.uk 


Q-TRANS 

Q~-Trns is a new pointer driven dual window file 
copier by Dilwyn Jones. What makes this one 
different is that it has both source and destination 
windows, you can see the contents of both the 
drive being copied from and the drive being 
copied to. Simply select the files to be copied in 
the appropriate window. click on the arrow bet- 
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ween the two file list windows and files will be 
copied. The copier has the usual overwrite op- 
tions, along with Delete, Execute, View and Print 
options like the QPAC2 files menu. Quick selec- 
tion of drive name and number via icons possible, 
along with awareness of Toolkit 2 defaults. Its 
display can be resized to suit displays from QL 
sized right up to 768 pixels high! 

Above all, it's designed to be simple to use! 
Q-Tans is part of a forthcoming QL Desktop pro- 
ject for QDOS systems, but capable of stand- 
alone use, So Is being released separately. It will 
be available on future versions of the DJ Bargain 
Bundle from Q-Celt Computing and available for 
download from websites and from QL PD libra- 
res. 
http://www.soft.net.uk/dj/software/freeware/freeware.html 


Gelete « Print 
Execute | Renana 


Q-Trans running in VGA mode 

QL-Users List on the Move 

The Internet Email Discussion list called QL-Users 
is now moving from its home at nvg.ntu.no. The 
move is due to antispamming measures being 
taken at the hosting site which has prevented 
people posting replies to the emails sent to the 
list. The list will now be hosted on Quanta’s do- 
main at quanta.org.uk. To subscribe fo the list 
send a message to: majordomo@www.quanta.org.uk 
with ‘subscribe ql-users in the content of the 
message, details on how to post messages wil 
then be sent back to you. If you have any 
problems with subscribing please contact 
bruce@q-v-d.demon.co.uk The mailing list is open 
to all not just to Quanta members and provides a 
lively discussion forum on QL/SMS issues. 
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SuperHermes Manuals 

Tony Firshman was kind enough to give Phoebus 
Dokos all the superHermes Lite manuals in elec- 
tronic form, so they could be posted online. 

Two versions will be posted for each manual. One 
in printable form that makes a A5 sized booklet 
and one in the regular (in-sequence) form. 

A replacement Aurora manual is also available 
from the same website. 

These will obviously be very helpful to anyone 
who has either lost their manuals or purchased a 
second user unit without manuals. This is 
becoming quite widespread in the outside world, 
making replacement manuals available online and 
is a development to be welcomed. 

The manuals can be downloaded from: 
http://www.dokos-gr.net/~ phoebus/ 

A reminder that replacement manuals for Miracle 
Systems Lid products (Gold Card etc) are also 
available from the Dilwyn Jones website. 


Dilwyn Jones PD Library News 
Version 1.20 of the QL Emulators CD will be 
available by the time you read this. It will feature 
the most recent version of UQLx emulator and up- 
dates to some of the most popular free software 
bundled on the CD such as Turbo and Editor. 

The PD library has grown to some 150 packages 
of QL software in total (some packages require 
more than one disk) and still expanding fast. The 
games section for example consists of 15 disks, 
but a total of about 110 game packages. 

The catalogue disk is available for download 
from my website, or send me an email to request 
it by email as a text file, or it can be obtained just 
by sending me a formatted floppy disk (or a. 
blank CDR if preferred). Some of the software is 
available for free download from my website, but 
I've just about run out of space there now to put 
many more packages on the site. It may be 
worth a visit to the Software pages on my site 
to see if the package you want is available for 
free download there first. 

Finally, Phil “The Library” Jordan and | have 
exchanged CD-ROMs of our respective PD 
libraries, so that we can work towards merging 
the available programs to be available from both 
libraries. The collection of available free software 
for the QL is now huge and it takes us both quite 
a lot of our time just trying to keep it up to date. 
Phil's entire library collection for example requires 
two CDRs to hold the whole lot. When you 
consider that a CDR can hold half a gigabyte or 
more of data, that's a fair reflection on the 
amount of QL software available. 


QL Today Joke 


from Norman Dunbar 


There are 10 kinds of people in this world - 
Those who understand binary, and those who 


don't! 


| guess if you understand the binary joke, 
you are qualified to read his assembler series 


Gee Graphics! (on the QL?) 


- Part 28 


H. L. Schaaf 


"Even More Connecting the dots"...... 


This time we add the Convex 
Hull to the menu. 

The convex hull is a subset of 
the Delaunay triangulation and 
is easier to show than explain. 
You can think of it as a bounda- 
ry that just barely encloses all 
the points, or what you'd get 
with a rubber band streched 
around the ‘outside’ points. 
Since we've already done the 
work of locating the hull as part 
of finding the Voronoi edges, 
we use the information to 
select Delaunay edges that 
belong to only one triangle and 
then show them. 

Continuing on from GG#27, 
take the — mixture of 
code5i_bas, D2V_bas, and the 
PROcedures for  angl_frm, 
dist_btwn, SWAP and CYC that 
we had, and then merge in the 
listing “AddHull_bas’. 

Some may have noticed a few 
qwirks if they tried to get 2 
squares from the grid option of 
the Inout menu. Looks like 
another little nudge is needed, 
So line 8285 has been used to 
give a better result. 

Also if you tried the random 
input with 42 as seed with 
anywhere from 23 to 54 points, 
you would have noticed a 
strange division of the regions, 
but probably only — with 
SMSQ/E. The 3 points num- 
bered 13, 15, and 23 on the left 
edge are almost collinear The 
triangle (#35) formed is an 
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extremely narrow sliver with 
one angle being very nearly 
180 degrees, so perhaps we 
have pushed the QL too far? 
This may be due to the way 
the random number is genera- 
ted, another fun area for ma- 


Listing AddHull_bas 


in QL Today! - Editor 


thematical investigations. Any- 
one know the algorithm used 
to give the random numbers? 
Still on my to-do list is pulling 
the Gee Graphics series toge- 
ther for posting on Dilwyn 
Jones website, where you can 
download the listings instead of 
having to type them in. 

I've added Steve Poole's Voro- 
nol program to my to-do list as 
well. 

Next time we hope to do the 
Gabriel Graph, another subset 
of the Delaunay triangulation. 


102 REMark AddHull_bas to go with GG#28 
112 REMark Convex Hull added April 30, 2002 HL Schaaf 


5800 
: INK #0, 4 
PRINT #0;" 
INK #0, 2 : 


5810 
5820 
5830 


5835 
'sest$; 


5840 INK #0, 4 : 
[C]lear screen,"; 


PRINT #0;"Delaunay : 


Voronoi : 
PRINT #0 ;" [R]Jegions, 
REMark PRINT #0;' [G]abriel, '; 
REMark PRINT #0;' [M]inimum spanning tree, 


PRINT #0;\" 


[Ploints, [T]riangles" ; 


[Vjertices, [E]dges" 
[H]ull, "5 


[ESC] to Exit, [C] to 


5972 IF ans$ == 'h' THEN INK 2 :ConvexHull : 
choose_options 
5975 REMark IF ans$ == 'g' THEN INK 2 :Gabriel : 


choose_options 


5978 REMark IF ans$ == 'm' THEN INK 2 :MinSpanTree : 


choose_options 


8285 IF (pat$== 's'):P(p_n,1)= P(p_n,1)-nudge 


9890 


9900 DEFine PROCedure ConvexHull 


9910 LOCal i 


9920 REMark choose the edges with only one triangle 


9930 
9940 


9950 END FOR i 


9960 END DEFine ConvexHull 


9970 : 


FOR i = 1 TO DIMN(Dedg) 
IF Dedg(i,0)=1 :show_edge(i) 


9980 DEFine PROCedure show_edge(edge_number) 

9990 POINT P(Dedg(edge_number, 1), 1) 
,P(Dedg(edge_number,1),2) 

10000 LINE TO P(Dedg(edge_number,2),1) 
,P(Dedg(edge_number, 2) ,2) 


10010 END DEFine show_edge 


10020 : 


10030 REMark end of listing AddHull_bas 


QL loday 


QL Cash Trader. v3.7 £5 


A well established accounts package for the small to 
medium sized business, including automatic 


generation of profit & loss account, balance sheet, VAT 
retums, reports and analysis for audit trails and 
management decisions. Previously sold for over £100.* 


QL Payroll. v3.5 £5 


Manage a payroll for a small to medium sized 
business. Handles up to 99 employees easily, 
producing P45s and P60s as well as the payslips on a 
monthly or weekly basis. Calculates tax and national 
insurance and is easy to update to take account of the 
current tax year rules. 


Q-Help v1.06 £10 
Q-Index v1.05 £5 


Q-Help: on-screen help for SuperBASIC commands, 
including TK2, Turbo Toolkit, SMSQ/E and PD toolkits. 
Can be used to add help to your own programs - 
simply produce ASCH text for each help page, add an 
index and Q-Help automatically cross-references and 
displays the links. 

The PD toolkits referred to are available for £2. 
Q-Index: The SuperBASIC index supplied with the 
Reference Manual - enter a topic such as ‘screen 
resolution’ and find out the commands which relate. 
Launch Q-Help for further info on the chosen 
command. 


Sidewriter. v1.08 £10 


Produce landscape printouts of Easel/Qspread 

spreadsheets and output from QL Genealogist, as well 

as any other standard text file. You can specify the 

fonts to be used on the page. Works with all EPSON 

compatible printers, from 9 pin dot matrix to laser 

pee. A most useful utility by Dilwyn Jones - you 
ow it must be easy to use. 


ProForma ESC/P2 Drivers v1.04 £3 


New improved colour and monochrome printeg 
drivers, providing up to 720dpi for all progy 
written for use with ProWesS, such as LineDesig 


support binary mode compression (740, g 
models at least). 1440 dpi to follow. 


QL Genealogist v3.26 
Genealogy For Windo,, 


Store your family tree 


with details of their Mil of A wealth of QL adventures - mainly text only. 
Save the Galaxy from the ambitions of the evil dictator 
Nemesis. 

Battle against werewolves and dracula look-alikes on a 
Hammer Horror set in the comical Horrorday. 

Take the part of a prawn with a hangover, lost in a strange 
land in the hilarious Prawn. 

Solve a bank-robbery by fighting the bad guys and 
collecting the loot in real-time old West. 

oe oo dwarves in the atmospheric Lost Kingdom 
of Zkul. 

Return to Eden is a massive adventure over 3 disks with 
colourful graphics - control 3 characters in their quest to 
find the missing Prince. 

All six adventures are available together for only £25. 


D-Day MKII v3.04 £10 For the gaming enthusiast - D-Day is a classic table top wargame for one or 


two players - you control either the Allies or the Axis forces during WWIL 
Grey Wolf v1.8 £8 With the ability to define your own army set ups and a choice of 4 different 


el Mh Ge ee aiimaeese scenarios, this should keep you entertained for a while. 
Grey Wolf is a graphical simulation of a submarine - can you sink the enemy 


(Upgrade Only) £5 shipping whilst avoiding their planes and destroyers?? 


______ RWAP Software, 7 Common Road, 
eel Kinsley, Pontefract, West Yorkshire 


those links build 
Text files and 
individuals ag 


layout. 
inked to 
f making this 
of your family. 

and QMenu as well 
ale and female trees. 
since 1066 included. 
- enter the details as they 
Md it generates the tree from 
DCOM can be transferred to the 
fe to latest PC version (v5.21) for £8 
Easy to use and complete with a step by 


Both program$ 
step tutorial. 
** OL USERS upgrade to PC version for £25 ONLY ** 


"WFO 5JR 
TEL: 01977 614299 
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VN yak 
Image D v1.03 £10 Beers 
Produce graphical representations of 3D objects - view g 2 av Bet 
them as wireframe, hidden line and shaded. vee age 
Perspective and magnification can be controlled and Gan, aoe 
views can be saved to file for subsequent printing. ey" fee 3 
Multiple objects can be defined and positioned relative 3 ay owe = 
to each other. Simple to use yet produces excellent a8 8 os 
results. Osu. By 
Les stisa 
SBASIC/SuperBASIC Reference Manual £40 Mama? ae Ba 
. 3 ja 2 
Updates: £6 each, £10 for 2. (Current Version - Rel:4 g= Syne A 
Have you ever tried to write a program, but been lost as to & PYyo Sas a 
* * 2 4 peoOnsd 
the means of performing a certain action? This Reference SO EA THEE 
Manual provides you with a full description and examples of | Bea e's 30 
how to use all of the keywords found on each of the 2% ge oss 
different QLs, plus SMSQ/e, Toolkit II and many different Bo “OB 5 
public domain toolkits. Details of any possible problems are < ES e525 a 


provided, together with descriptions of how to use the 
device drivers and how to ensure that your programs are 
compatible across the range of QL platforms. 

This book is ideal for all QL users and is kept up to date with 
regular updates. 

Orders are currently being taken for the next print run of 
this popular tome. 

(Note: Price for the book does not include post & packing). 


QL Cosmos v2.04 £5 
Ever wondered what the stars in the sky looked like 100 
years ago? Or, maybe you want to learn the constellations 
and names of what you see in the sky. This is the progray 
for you - generates pictures of the stars and planets for, 
given place or time and provides details on these g¥ 
Includes Halley's Comet, the Moon and the Solg 
planets. 


Q-Route v2.00 


£8 
£5 
£5 
£5 
£10 


nistrike v1.5 
F..ghtdeck v1.05 


Al 


, NE England, NW Englar 
, Wales & Derbyshire, London area 


Upgrade from v1.xx 
The latest version of this pop CES | 
Find the quickest route or thg Brg = 
two places, using roads. A Wing 
for this program (see elsg 4 


is easy and quick to 


g°2 3 

3 

uv 7 

wo & 

2e58 g 

Bo 8 io) 

go ak a 

and roads to the 28 a ee 
age geo fo 

he Owe S 3 

ely fast and flexible, 7 2's § 5 

he latest versions of the .° £°5 = & 

mtained. A report module is, zi ay ae Eo 

At output in any way, including &= 2 Some 
Only available as an upgrade from EET 9-5 ES 
riginal still available from Sector ,» Os “ge 
Uw gi, BEG 

OSES BS 

Cathy ou AH 

vShBUS5 a 

auyveses 

BHHGESAES 


£2 
£5 
4 


details) £2 ea. 
£5 
£2 


(needs 2MB) v2.03 
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Britain.map v1.11 
BIG Britain Map 


V 


Cheques in £sterling 


* Also known as Trading Accounts payable to 'R. Mellor' 
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The QUANTA Workshop and 
AGM in Manchester 


Dilwyn Jones 


On Saturday 13th and 14th 
April, the local Quanta sub- 
group in Manchester, 
NEMQLUG, hosted a Quanta 
workshop on the saturday and 
the Annual General Meeting on 
the sunday. Attendance was 
pretty good on the saturday 
but rather poor on the sunday, 
so this may mean the end of 
two day workshops in England 
anyway, apart from special 
international events like the 
QL2000 meeting. 


Inside the hall early on the Saturday | 


The saturday workshop was 
timed to start at mid day, which 
was a bit of a departure from 
the norm, as the intention was 


to allow the southern traders 
time to travel north on the 
saturday morning - would the 
same arrangements have been 
made for southern workshops | 
wonder? 

The venue was the local 
Scouts hall, a very short dis- 
tance from the M60 motorway, 
sO very easy to find, an im- 
portant consideration when 
you have a sense of direction 
like mine! 

From the 
first = mo- 
ment, it be- 


a signifi- 
cant num- 


Turned out 
to be the 
staff of D & D Systems along 
with Peter and Claus Graf and a 
few assorted Q60s_ which 
everyone was drooling over all 


day (the computers anyway, 
don't know about the staff). 

D & D Systems have put toge- 
ther quite a bundle of well 
known QL software to en- 
hance the Q60 experience. 
The Q60 comes with a sump- 
tuous manual as well, once you 
inherit a Q60 you have a lot of 
getting used to the sheer po- 
wer and variety available to 
youl 

From the largest presence at 
the show to the smallest. Keith 
Mitchell had one of the smallest 
‘QL’ systems I'd ever seen. 
Running multiple copies of the 
uQLx emulator this tiny little 
laptop was quite an attraction in 
itself 

Surprise appearance at the 
show was by former QL trader 
David Batty, who was one of 
the leading QL software tra- 
ders in the 1980s. David has 
been keeping a close eye on 
the QL scene via the internet 
and has lately been taking an 
interest in the Turbo compiler 
source code due to his interest 
in compilers generally. He stil 
has several QLs, he said, and 
took away with him a copy of 
the QL Emulators CD so we 
may be hearing more from him 
in the future! 

Another pair of suspicious cha- 
racters were lurking about the 
show, taking video pictures of 
anything that moved and quite 
a lot that didn't. Turned out to 


Keith Mitchell's little laptop running multiple uUQLxes - note the size} 
compared to the little biro above the keyboard 


eith Mitchell with his hands in a QL of some sort as usual 
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The mysterious man with a video camera 
Steve Reyal preparing footage for the QL DVD 


be Steve Reyal and Darren Bra- 
nagh, both busily preparing ma- 
terial for the QL DVD, a promo- 


tional video about the QL 
scene in 2002. They had pro- 
duced a short trailer for this on 
floppy disk (some PC video 
format), recorded and pro- 
cessed to look like one of 
those scratchy newsreel films. 
Rather corny, but attention 
grabbing all the same. | look 
forward to seeing the finished 
version - hopefully it will be 
good ‘propaganda’ for the QL 
scene. 

Jochen Merz, Tony Firshman, 
Geoff Wicks, Q-Celt Compu- 
ting, Bill Richardson and Roy 
Wood of QBranch had all made 
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the trip to the show, but 
Rich Mellor of RWAP 
Software was 


again a Bernd fhe refuse write an article 
unable to attend due to § int his pictur punishment) 


ongoing illness. He is ™@ 
making a slow recovery, but 
not yet well enough to travel 
long distances. However as 
readers of the QL-users email 
mailing list will know, he is still 
actively programming and 
releasing new software and 
updating other programs. Most 
of his products, including the 
excellent updated Q-Route 
v2.0 route finding software, 
was available from other 
sources at the show 

Geoff Wicks has been drop- 
ping some hints recently about 
a new product from Just 
Words. His adverts have 
carried the question- 
marked black briefcase, 
but despite repeated 
attempts to extract the 
information from him, a 
quiet smile was all | got, 
so | guess Ill have to 
wait until his QL Today 
news items come in 
before I'l find out what it 
IS. 

Jochen Merz and Bernd 
Reinhardt manned the 
JMS stand. Jochen was 
selling the latest release 
of QPC2 which among 
its newer tricks can now 
BEEP from the host PC’s 


speakers, rather than the [Our publisher at the show — Jochen Mer. 


rather pathetic little system 
speaker. This is more important 
than it may seem - Windows 
NT users had problems getting 
audio out of the system 
speaker before, so now you 
can hear the QL beep as loud 
as you want (or can tolerate!). 
Despite this, QPC2 has some 
way to go before it can match 
the 20kHz stereo audio from a 
Q60 for example, or a QDOS 
Classic system equipped with 
the QL Sampled Sound System 
(QLSSS) 


SS 


A well stocked ‘bring and buy’ 
stand (pair of stands actually!) 
meant there was plenty of 
older QL goodies to browse 
through and snap up at bargain 
prices. 

Q-Celt Computing 
and | claimed the 
record for the 
shortest time ever 
for a QL CD-ROM 
to go from con- 
cept to production. 
The QL Documen- 
tation CD went 
from an idea Dar- 
ren and | had over 
a beer the night 
before the show 
to being sold the 
following day - tt 
took us just 3 
hours to produce 
the night before 
the show. It brings 
together into one collection the 
publicly available text files and 
documentation and articles 
about the QL, its hardware and 
software and programming in- 
formation. The idea is that it will 
act as a single source of freely 
available documentation, which 
we hope to continuously up- 
date as more material is contri- 
buted. Costing just 5 pounds 
(plus postage if ordered by 
mail) this CD proved to be a 
good seller at the show and 


Q60 Droolers 
Corner 


Well, you can drool over the 
computer, [m not so sure 
about the staff There was 
so much QL-style black on 
this stand, | hope the 
pictures won't be too dark! 
Anyway, here's some pic- 
tures of the Q60 itself along 
with the men behind the 
Q60 and D & D systems. 
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several people promised to 
send more material for it over 
the following weeks. The CD 
itself is freeware and may be 
freely copied subject to any re- 
Strictions imposed by individual 
authors of the material sup- 


plied, for example, since a text 
file copy of the QL manual is 
included, it would be necessary 
to obtain permission from the 
rights holders in north America 
(Paul Holmgren or Frank Davies) 
to use the CD there. 

A ‘social event’ (dinner) was 
held on the saturday night. 
Sarah Gilpin had organised this 
function by taking advance 
bookings from those interested 
in attending. | did not attend 
myself, so cannot report on the 


rek Stewart of D & Systems 


normally lengthy discussions 
on QL matters which take 
place at these “social events’, 
but thank you Sarah for orga- 
nising this function. 

The AGM itself on the Sunday 
proved to be an uncontrover- 
sial_ affair Long 
serving treasurer 
John Taylor is 
retiring from the 
post this year 
and his place will 
be taken by John 
Gilpin. John 
Taylor was 
thanked by all 
present for his 
service. A minor 
error on the 

paperwork 

issued with the 
newsletters in 
advance of the 
AGM meant that 
there was some uncertainty 
over the position of one of the 
officers, but after a short dis- 
cussion the AGM concluded 
there need be no problem after 
all. A discussion was also held 
as to who should be appointed 
auditor this year since the 
smaller membership of the past 
couple of years meant. that 
there was less work for an 
auditor and some savings 


could probably be made on 
auditing fees. 


la Dennis Smith of D & D Systems 
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Claus (left) and Peter Graf, the Q60 designer 


Another Q60 computer, seen from front and bac 


A Q60 computer featuring twin floppy disk drives 
ROM drive, CD-Writer (currently used from 
inux, but hopefully SSMQ/E will manage 


A tenner 
for our 
autograph? 


QL-THESAURUS £10 or €15 each QL-2-PC TRANSFER 
STYLE-CHECK QL-RHYMES 


Tel: +44 (0)1268 281 826 — Email: geoffwicks@hotmail.com 
Web: htto:/‘members.tripod.co. uk/geoffwicks/justwords.htm 
Just Words! - Software for Writers and Word Lovers. 


( ( Geoff Wicks, 28 Ravensdale, Basildon, Essex, SS16 SHU, UK. 
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Pointer Programs 


John Perry 


QL Today is often quick to promote the virtues of pointer 
environment and SMSQ/E, hardly surprising perhaps since the 
publisher sells SMSQ/E. | ventured to ask the editor why, given 
the amount of PD software there is for the QL, so few reviews 
of the ever increasing number of such pointer driven programs 
were published in QL Today. His reply was brief and to the point: 


"Nobody writes any for us - why don't you?” 


So, | did. | duly obtained some 
disks of QL PD software and 
decided to try writing some of 
my views about these pro- 
grams. You may not agree with 
what | write, but this is what | 
think of them. Here's my first 
review. 


SPELLING-CRIB v2.10 
by Geoff Wicks 

This freeware program is from 
the highly respected Just 
Words stable and it shows. It's 
not a true spelling checker as 
it's name implies, but rather a 
utility for helping to find the 
correct spelling of difficult 
words. 

This version relies on the pre- 
sence of QTYP Tony Tebby’'s 
pointer driven spelling checker 
program. QTYP is a long esta- 
blished program, capable of 
checking the spelling of words 
as you type or checking entire 
files. QTYP is a commercial pro- 
gram and rather a heavyweight 


one at that - it is not the 
easiest of programs to set up 
and use. lf you do not have 
QTYP you will not be able to 
use this version of Spelling- 
Crib. Rather, you should obtain 
a copy of version 1.00 from the 
author which instead makes 
use of plain text file 
dictionaries. | have not 
seen that version, so 
can't comment. 

QTYP dictionaries are 
sizeable ones (the one § 
supplied with Spelling- 
Crib has about 65,000 
words and is about # 
120KB_ long, dwarfing 
Spelling-Crib itself. which 
is only about 40KB) and 
may be edited by the 
user using the QTYP dictionary 
editor Over the years, several 
additional dictionaries have 
been created by users world- 
wide, so there should be a 
good choice of dictionaries 
available - only one English 


Spelling-Crib opening screen 


61998 Geoffrey Wick 
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B ESC - return : 


dictionary is supplied with 
Spelling-Crib, though if you 
have another QTYP dictionary 
it should be possible to use 
that, as Spelling-Crib allows you 
to configure the path and 
filename of the dictionary. The 
same configuration makes it 
possible to make it run from a 
directory on a hard disk. The 
copy | got from a PD library was 
ready configured to run from 
FLPL_. 

It is also possible to tell the 
program where to find the 
dictionary by passing its 
filename to Spelling-Crib as a 
parameter in an EX command: 
EX WIN1_CRIB_SPELLCRIB_OBJ; 
"WIN1_CRIB_QTYP_DICTIONARY" 


The Help screen 


ANY OTHER KEY - more help 


As might be expected of Geoff 
Wicks, the manual is a total 
pleasure to read. All the in- 
formation you need, including 
system requirements and a 
‘Quick Start’ section are there. 
The manual! tells you every- 
thing you need to know with- 
out waffling on at great length. 
The manual is a straightforward 
Quill DOC file. Beware though, 
there IS a separate 
UPDATES_DOC file which you 
should also read. The manual 
warns that users who have 
other programs making use of 
QTYP (eg. the Text 87 spell 
checker) may have programs 
as apparently only one pro- 
gram at a time can use QTYP 
As | don't have Text 87, | could 
not test this. 
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At 40KB the program itself is 
probably so short that no 
version without linked compiler 
runtimes iS necessary. For 
those unfamiliar with — this, 
QLiberator compiled pro- 
grams can come in two 
forms, one for people 
who already have the 
compiler and another for 
those who don't. A little § 
library file about 10KB 
long called QLIB_LRUN 
(QLiberator Runtimes) is 
needed for QLiberator 
compiled programs to 
run. This can be compiled 
into the program so that 
the program can run stand- 
alone with no need for the 
compiler to be present. The 
snag with this though is that if 
you run several such programs 
each having runtimes linked, 
you are essentially wasting 
10KB of memory each time. 
Some software authors pro- 
vide versions of their programs 
which don't have these runtime 
libraries built in, so if you have 
the compiler itself. on your 
system you can use slightly 
shorter versions of these 
programs. Sadly, Spelling-Crib 
does not provide this feature, 
you get the one version with 
linked compiler runtimes and 
that's it. At least it makes life 
simple that way and frees you 
from worrying if your version of 
QLiberator is modern enough 
for this program. And in these 
days of large memory QL 
systems we're probably not 
going to worry too much about 
a program being {0KB longer. 

The program is pretty well 
Standard Just Words black and 
white - if you've seen any 
Geoff Wicks pointer driven pro- 
grams they tend to look pretty 
alike in terms of screen appea- 
rance, he seems to have deve- 
loped his own in-house style. 

To search for a word, you need 
to know what letter it starts 
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with. Unknown parts of words 
can be represented by a for- 
ward slash character So if you 
didn't know how to spell “cha- 
racter’ you could click on the 


INPUT item (see the screen 
dumps to see how the display 
looks} and enter ch/er - the 
program would then list all 
words it knew which started 
with ch and ender with er - 
quite a few of them! 

The program can go a step 
further than this. You can spe- 
cify more than one ‘wildcard’ if 
required. Try entering some- 


Entry of search word 


thing like a/b/c. | didn't think 
this would list many words, but 
actually it did manage to find 
quite a few. Again, see the 
screen dumps for an example. 
lf the program finds more than 
a screenful of matching words, 
there is a little item you can 
click on called PAGE DOWN 
which will step through the list. 
When you reach the end of the 
list, the writing in that button 
becomes hard to read and it 
becomes no longer available, 


So indicating you have reached 
the end of the list. Similarly 
there is a PAGE UP button, to 
allow you to go back through 
the list if required. 

The use of ‘/° as a wildcard 
seems a bit unusual - | am 
used to entering a "*" as a 
wildcard of any number of 
letters, or *?” to represent a 
single unknown letter Wild- 
cards are symbols which repre- 
sent unknown letters, so a/d 
could be ‘and’, “abandoned”, or 
‘abated’. You get the idea. 
Perhaps the reason in this case 
is that Spelling-Crib does not 
need to make the distinction 
between single unknown cha- 
racters and groups of letters - 
the "/” can represent one or 
any number of characters. 
Don't try to start a search with 
a wildcard character, it won't 
work. You have to know the 
first letter of a word. Therefore, 
a/ will work but /a will not work. 
Trying to be clever, | attempted 
to list the entire dictionary by 
, just entering a single / 
character or a double // 
The program just com- 
plained ‘unsuitable entry’ 
| and asked for another 
a entry. 

It is possible to step 
through the dictionary 
one letter group at a time 
though, by entering a/ or 
b/ and so on. It surprised 
me to find that the dictio- 
nary started with half a 
dozen entries all starting a 
double a. The dictionary in- 
cludes some proper nouns as 
well as the usual dictionary 
entries. 

When entering a word, the 
program does not allow you to 
ESC out of a new entry or 
even make a blank entry, in 
order to go back to the 
previous listing. Not a serious 
problem at all - you just enter 
the same wildcard again. 
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The program has a short built 
in HELP facility, enough to use 
the program without reverting 
to the manual every time you 
need to use Spelling-Crib. To 
wade through the help text, 
you have to press a key on the 
keyboard - PAGE DOWN and 
PAGE UP are not active. You 
can, though, press the right 
mouse button to step through, 
presumably this just acts like an 
ENTER keypress. Similarly, 
when you use the QUIT button, 
it asks for Yes/No confirmation 
via keypresses, no option to 
respond using a mouse. 
Spelling-Crib has the usual 
MOVE and SLEEP icons. If you 
click on 2zz and you have 
Qpac 2 installed, the program 
goes to sleep as a ‘button’ in 
the button frame. The double- 
square move item lets you 
move the program's display to 
another position on the screen. 
As the program uses less 
screen area than the QL 
512x256 screen this is quite 
useful - especially when using 
larger sized displays. The pro- 
gram can be parked at the 
most convenient part of the 
screen. 

The program runs either in 
QDOS with pointer environ- 
ment or in SMSQ/E. In both 
cases, QTYP must be present 
(obtainable from QBranch_ for 
about 30 pounds), and the 
system must have Toolkit 2 
(available on most modern QL 
systems and interfaces, inclu- 
ding SMSQ/E). 

Spelling Crib is freeware and 
should cost no more than 
about a pound from most sour- 
ces of PD software or direct 
from the author himself The 
review copy came on disk 
GE05 from the Dilwyn Jones 
PD Library Service. Just a 
pound for a program of this 
quality is a real bargain. 
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System Set 

by Dilwyn Jones 

System Settings is an uninspi- 

ringly named program to pro- 

vide facilities to, umm, change 

system settings. It's a pointer 

driven program and although it 

sets out in what it achieves to 

do is not the most exciting of 

programs and does not seem 

to have been that well publi- 

cised - | stumbled across it 

rather than set out to find it 

Although | am quite glad to 

have found it in the end. 

Like most of the author's offe- 

rings, this one is easy enough 

to use and has a few quite 

good points, but is not exactly 

a program which stands out 

from the crowd. 

The program needs pointer 

environment and Toolkit 2. 

There are 5 broad functions of 

this program. 

{. Clock setting - time and 
date 

2. Device names - renaming 
the device drivers 

3. System defaults - setting 
DATA_USE etc 

4. Directory creation 

5. File selection and starting 


lf you have ever used system 
setting software in other ope- 
rating systems such as the 
Windows Control Panel, you'll 
know how fiddly and awkward 
they can be, especially if you're 
not sure what you are doing 
and object to having half a ton 
of paper on your lap. Thankfully, 
System Settings is quite easy 
to use and on the whole you 
could probably get away with 
no manual, as long as you 
understand the use of 
DEV_USE commands and the 
like. 

The first allows you to read and 
set the system clock. While 
using SDATE from BASIC is not 
exactly a pain, it does mean 
you have to remember the 
order of the parameters and 


check if the clock is correct. 
System Settings gives you a 
box (see the screen dump) with 
6 smaller boxes and ‘READ 


bt a ae eee 
ystem Settings opening screen 


CLOCK’ and ‘SET CLOCK’ 
items. Read Clock displays the 
current time and date. Clicking 
on Year, Month, Day, Hour 
Minute, or Second boxes lets 
you type in a value for any 
which are not correct. 

Once entered, simply click on 
SET CLOCK and the clock time 
will be updated. Nice and 
simple, the only complain | 
would make is that perhaps a 
continuously updated clock 
display (the Toolkit 2 CLOCK 
command for example) could 
be shown as more than once | 
found that by the time Id 
clicked on SET CLOCK | was a 
second or two out afterwards 
because I'd clicked too soon or 
just too late. The display of this 
program is a little cluttered 
though due to the sheer num- 
ber of items it is able to alter, so 
perhaps the distraction of a 
constantly changing clock dis- 
play would just add to the 
clutter and you could simply 
Start one of those ubiquitous 
little clock programs running 
while using System Settings. 
The next section lets you alter 
the device names on your 
system. This facility is just like 
FLP_USE, DEV_USE and such 
commands. Indeed, being com- 
piled BASIC, this program pre- 
sumably makes use of those 
extensions. 

You can set new 3 letter 
names for the FLP DEV, PAR, 
PRT RAM, SER and WIN 
devices. As long as the equi- 
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valent xxx USE commands 
are present on your system 
presumably. Not all systems 
include a WIN_USE command 
or SER_USE command so 
these may not be useable on 
some systems. 

The third section lets you alter 
what it calls ‘system defaults. 
This consists of data default 
device (DATA_USE), program 
default device (PROG_USE), 
SPL_USE, DEV settings for 
DEVI and DEV2 and the 
desination default (DEST _USE}. 
Not a lot to say about these 
except that they allow you a 
good length of input and seem 
to work exactly as described. 
The Make Directory box simply 
lets you type in the name of a 
directory and creates that 
directory. Avoids the need for 
MAKE_DIR) commands from 
BASIC. Obviously, will only 
work on systems which sup- 
port making such directories 
(Level 2 or higher filing sys- 
tems), not on very old disk 
interfaces. | think the Trump 
Card was the first disk interface 
to support these (open to 
correction on this!) 

Make Directory appears to of- 
fer no advantage over a 
MAKE_DIR command until you 
explore the final option, the 
‘floppy disk icon’ box. Click on 
the red and white floppy disk 
and up pops a rather nifty file 
display box from which you 
can display lists of files on 
given drives via single key- 
presses or mouse Clicks. Along 
the top, predefined buttons 
appear for CDR (CD-ROM?), 
DOS, FLPMDV, RAM, ROM and 
WIN devices, with further but- 
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tons for drive numbers 1 to 8. 
These appear to be hard 
coded into the program and 
are always shown even though 
the device is not present on a 
system, eg. | have no CDR 
device but CDR is available. 
Also if device names are 
changed these don't update. 
So to view files on FLP2_ just 
click on FLP and on 2. 

The <- button acts rather like 
a similar one in QPAC2 in that it 
goes back one level of direc- 
tories. Imagine you had direc- 
tories set up as follows. WINI_ 
contains a directory called 
Psion, which in turn contains a 
directory called Quill which 
itself contains asub-directory 
called docs. If you were 
displaying the list of fiels from 
WINi_PSIONS_QUILL_DOCS 
and clicked on the <- button, it 
would take you back up to 
WIN1_PSIONS_ QUILL_ 

In the list of files itself, each 


The File Selection list 


filename is preceded by a 
character which indicates the 
file type. An executable pro- 
gram (one you can EXEC) has 
an E before it. A directory has a 
> symbol in front of it, and 
although | don't know what an 
S-ROFF file is, apparently 
these are preceded by a letter 
R. If you click on a filename 
preceded by a >the program 
goes on to show a list of fiels in 
that directory So you can 
browse through directories on 
a hard disk or ED disk by 
clicking on > to enter that 
directory, or <- to go back. 
Quick and convenient. 

lf you left click (HIT in QL termi 


nology) on a filename, the pro- 
gram’s next trick is to stuff that 
filename into the stuffer buffer. 
lf you then go into another pro- 
gram and press ALT SPACE 
when it asks for a filename, the 
filename is "typed’ into that pro- 
gram. In effect, this program 
can act as a pointer driven file- 
name selector for any program, 
even non pointer driven ones 
like Quill 

That would have been useful in 
itself but an extra surprise 
awaits. Right click on a_ file- 
name and a box pops up with 
brief details on the file - its 
length, full path and filename, 
the file type and the date last 
updated. Click on OK to clear 
this box. If the file was an exe- 
cutable one, you can even 
execute it by clicking on the 
EXEC button. A further menu 
appears allowing you a wide 
range of execution options. 
Memory grabbing programs 
like Quill can be tamed by 


specifying how much memory 
allowed, like the P Psion option 
in QPAC2 hotkey commands. 
Guardian windows, freeze (for 
programs which don't suspend 
when you CTRL C out of them) 
and Unlock Windows | (for 
programs like clocks which 
need to write to the display all 
the time irrespective of whe- 
ther they are the currently ac- 
tive program or not). A com- 
mand line can also be passed 
to the program, e.g. if starting 
an editor and the program 
allows you to pass the filename 
of the file to be entered, some 
programs also allow their de- 
fault drive details to be passed 
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in this way (e.g. Spelling-Crib!) 

Mostly, you will not be using 
these options, and will just click 
on EXECUTE to. start the 
program. 

It appears that only programs 
can be executed. System Set- 
tings does not seem to be 
aware of Filelnfo |, which would 
have allowed you to execute a 
data file and the system would 
fire up the program associated 
with it. 

Having used the DEV and other 
settings before executing a file, 
you can even use this program 
as a limited program launcher 
for older awkward programs 
like Quill which aren't aware of 
hard disk directories and have 
habits like gobbling up available 
memory when they start. 

The program has the usual 
Move and Sleep items repre- 
sented by the double square 
symbol to move the program 
around the screen and the 2zz 
symbol to make the program 
go to sleep in the button frame. 
The Copyright symbol brings 
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gSystem Settings copyrigh 
screen, including that dragon! 


up a little copyright screen, 


which displays the author's 
contact details and a cute little 
Welsh dragon. Incidentally, try 
clicking on the dragon to see 
what it says (discovered that 
one by accident, seems to be a 
little hidden feature) 

Leaving the program is by 
clicking on a little [X] icon in the 
top right hand corner and you 
get a little confirmation Yes/No 
box to check if you really wan- 
ted to exit, although with a pro- 
gram of this kind where there is 
no data to save, it’s not strictly 
necessary and it would be nice 
to have an option to configure 
this to be disabled. 

As it stands, you can configure 
just the file selection menu. You 
can specify the drive it first 
shows and whih directory, plus 
the number of fiels the list is 
able to show. 

A curious “feature” of this pro- 
gram in earlier versions was 
that if a drive had just one file 
on it, the program failed to 
show that file. Correspondence 
with the author revealed this to 
be down to a problem getting 
menus in the programming tool 
he uses (Easyptr) to display 
menus with just one entry. Just 
before sending off the first ver- 
sion of this review, he sent me 
an updated version 1.03 which 
seems to fix this problem. 

The program comes with a 
Quill DOC file manual which is 


adequate but not outstanding. | 
suppose it’s not easy to write a 
good interesting manual for this 
kind of program. 

It is hard to either put down this 
program or praise it. It sets out 
to do something and does it, 
although seems to have lost its 
way a little on the way A 
System Settings program 
which also has a file selection 
utility? Doesn't quite seem to fit 
the bill somehow. 

Also, | would have liked a 
‘System Settings’ program to 
offer additional facilities like 
setting mouse speed, key- 
board auto-repeat settings and 
the like. Also, I'd like to see the 
devices list contain only devi 
ces which exist on the QL sys- 
tem it's being used on. While I'd 
hardly urge it to be a Windows 
Control Panel for the QL, it 
does manage to be useful and 
distinctively QL rather than just 
like any other system settings 
utility on other computers. In 
summary, I'd say this is a good 
program, one point away from 
making the move from a good 
program to a very good one. 
Not everyone will want a pro- 
gram like this, but for anyone 
who does, this will fit the bil 
quite well. It seems robust and 
easy to use without being 
confusingly full of facilities 
you'd never use half of 


Kodak Digital Camera 
Driver for Qdos 


by Simon N Goodwin 


This article explains how | have made it possible 
to use a Kodak DC-series Digital Camera from a 
Qdos or compatible system. The driver works 
with several models of camera and many Qdos- 
compatible systems - the only thing you really 
must have is a serial port capable of reading a 
block of a thousand or so bytes at a time without 


stopping. 
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This work was first demonstrated at QL2000 and 
has since been tested by eminent Qdos users 
including Darren Branagh, Claus Graf, George 
Gwilt, Phil Stokes and Per Witte. It is known to 
work with SuperHermes, Qdos Classic on any 
Amiga or Q40 or Q60, UQLX, and SMS on Atari 
ST. TT Q40 and Q60. It does not work with the 
8049 QL IPC or Amiga Qdos because the camera 
output over-runs the serial input buffer 


The article also explains how digital cameras 
work and what they can do, and why some work 
with Qdos and some will not, with specific and 
general tips on choosing compatible ones. The 
driver is freely available on Dilwyn Jones's web 
site, at http://www.soft.net.uk/dj/software 
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New Millennium. 
New Century. 
N e W QL. What more could you want? 


Features 

x Q40i : 68040 CPU, 40 MHz, MMU, FPU 

x Q60/60 & Q60/66: 68060 CPU, 60/66 MHz, MMU, FPU 
Q60/80: 68LCO60 CPU, 80 MHz, MMU 

68060 superscalar architecture, dual execution units 
Up to 160 BogoMIPS performance for Q(DOS+SMSQ/E 
16 to 128 MB RAM, PS/2 module sockets 

256 kB ROM (mainboard supports up to 1024 kB) 
Highspeed 32 bit graphics, plus original QL modes 

Up to 65536 colours at 1024 x 512 pixel resolution 
Multisync monitor output (15 pin HD connector) 

PC Keyboard interface (DIN) 

20 kHz Stereo sound 

Battery buffered clock, 2 KB nonvolatile RAM 
Controller for 2 floppies and 2 IDE harddisks or CDROM 


2 Serial ports with 115200 Baud, Parallel port (on I/O 
card supplied with mainboard) 


Hardware extension slot supports ISA cards 

Fits directly into AT Minitower or other standard case 
+5V / +12V power supply 

No tinkering, no parts from original QL needed 
Mainboard size 8.2 x 6.3 inch 

Can boot SMSQ/E in a few seconds, directly from ROM 


Three different operating systems available! 
SMSQ/E, QDOS Classic, Q60 Linux 


£ 284.00 | 
£ 390.00 | 
£ 463.00 | 
£614.00 | 


£17.00 | 
£34.00 | 
£36.00 | 
£53.00 | 
£72.00 | 
/O Card (FLP,IDE,SER,PAR)** £ 14.00 . 
Operating System . 
SMSQ/E for Q40i/Q60** £10.00 | 
QDOS Classic for Q40i/Q60* free | 
Q60 Linux CD £15.00 | 
Ethernet Card 10 Mbit/s £17.00 | 
Cased assembled computers : 
Type A (Mainboard in case) £ 40.00 | 
Type B (Fully built system with < 
mainboard, 1.44 MB Floppy, u 
20 GB Harddisk, 54xCDROM) £ 152.00 a 
Preinstalled software package : 
QPAC1, QPAC2, FiFi, QD, 
PROWESS and much more, . 
over £100 worth £59.00 : 


x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 


*“ Standard parts, always required for operational mainboard *on mainboard support disks 


Shipping and handling is extra. Prices may change due to semiconductor costs or exchange rates. All 
mainboards with VGA lead, sound adaptor, support disks and manuals. Please note: The Q60/80 Is not 
available with floatingpoint coprocessor. 


Website and technical information: 


www.q40.de 
Email: info@q40.de 


D&D Systems 


P.O. Box 5813, Ripley, Derbyshire, England DE5 9ZR 
Tel. +44 (0)1773-740170, FAX +44 (0)1773-748399 


Email: sales@q40.de 
Financially assisted by a loan from QUANTA 


Take the power back in your hands. 
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Digital Camera concepts 


Digital cameras all do much the same thing. They 
are portable devices that take and store pictures 
and transfer compressed images to computers. 
The greatest variation comes in the way they 
store and transfer the images - there is no 
standard for the messages that pass between 
the camera and computer This Qdos driver is 
based on information provided by Kodak, which Is 
why it works with some of their cameras, and not 
others. The choice of Kodak was determined by 
their policy of making protocol details available, 
unlike most vendors, and because they make 
capable cameras that are readily available. 


The cameras have various internal settings, for 
things like the time, flash, Zoom and image quality, 
such as resolution in pixels and degree of com- 
pression). These are stored in tables internally - 
one table gives the current settings, while ano- 
ther is attached to each image, storing the set- 
tings when that picture was taken. The digital ca- 
mera driver allows access to these tables, as well 
as commands to make the camera do things and 
access to the stored photos. 


Raw image data is usually compressed in JPEG 
format. This familiar open standard was devised 
by the Joint Photographic Experts Group and 
does an excellent job of packing photographic 
images to a tenth, or less, of the space they'd 
otherwise need, without obvious degradation. 
There are several QL programs to decode 
JPEGs, of which Dave Westbury's Photon is my 
favourite as it's small, very compatible and deli- 
vers fine results even on a standard QL screen. 


Top resolution of the typical ‘megapixel’ cameras 
supported by this driver is 1152 by 864 pixels, so 
Photon scrolls those or larger JPEGs across the 
QL screen. Each JPEG image delivers a 24 bit 
colour value for each pixel, comprising eight bit 
Red, Green and Blue components. Internally most 
of the currently-supported cameras use a 1160 by 
872 point CCD or ‘Charge Coupled Device’ sen- 
sor array. Since the resolution is part of the image 
data, the same driver can read images with more 
or fewer pixels. 


DIY digicam 


The CCD i's essentially a dynamic memory with 
the lid off Twenty years ago hobbyists made low- 
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resolution cameras by prising the lids off 4116 (16 
kilobit) DRAM chips and focusing light on the ex- 
posed surfaces. Each bit in a DRAM is represen- 
ted by an electrical charge, which leaks away un- 
less it is regularly re-written - hence the need for 
such ‘dynamic’ memory to be ‘refreshed’ many 
times a second, to ensure that it doesn't forget 
your data. 


Like the EPROMs used in the QL cartridge port, 
RAM happens to be light-sensitive, so the inten- 
sity of the light falling on each part of the memory 
grid determines the speed with which the charge 
is lost. Normally the chip is covered, but if you 
uncover it you can take pictures by writing the 
same value to each bit and waiting for it to decay 
to the opposite state. The longer this takes, the 
darker the corresponding point in the original 
image. Within milliseconds you've got a grey- 
scale picture. 


Modern digital cameras work the same way, but 
offer more than the few thousand bits possible 
with a 4116 chip, a more regular array, and filters to 
distinguish colour The pattern of the filters is a 
grid, alternating by row and column, known as the 
‘Bayer’ or ‘CFA’ pattern. This is tailored for JPEG 
compression and the vagaries of human sight. 


The first row of sensors responds alternately to 
red and green pixels. The next row responds to 
green and blue, and so on for odd and even rows 
and columns. The intensity of white light can be 
measured for every pixel, but the exact colour 
can only be known for groups of four 


The basic pattern is square, two pixels on a side, 
rather than rectangular. There are twice as many 
green points as there are red or blue, matching 
the sensitivity of human eyes - to mix RGB com- 
ponents to grey scale, you need more green than 
of all the other components or the mixture has a 
purplish tint. 


Most of the images | collect are taken at the VGA 
resolution of 640 by 480 pixels, which the camera 
supports as an option; this is fine for web pages 
and relatively quick to store and load. |! only use 
higher resolutions for images that | want to edit 
later or submit for printing in glossy magazines. 


Even modern digital cameras offering millions of 
pixels barely approach the resolution of 35 mill 
metre film, but unless you are an expert photogra- 
pher using a tripod, expensive lenses and a good 
lab the practical limit will be your expertise, not 
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the technology; even heavily compressed VGA 
resolution images can yield results that look as 
good as compact camera prints to a non-expert, 
if you get them printed on the same paper Boots 
and some supermarket developing services can 
now print from memory cards as easily as they 
can from photographic film. Results are better 
than if you print the images at home, though Phil 
Stokes has done quite well with Photon and his 
Qdos-driven inkjet. 


JPEG deliberately exploits the fact that human 
eyes resolve more accurately in grey-scale than 
they can in colour The first step in compressing 
an image, as with the video standard MPEG, is to 
divide the data into colour and brightness infor- 
mation. 


Colour data is sampled at half the rate, vertically 
and horizontally, of that used to measure bright- 
ness. Only one colour value need be processed 
for every four brightnesses. The lower spatial re- 
solution of the eye for colour means that humans 
don't notice the missing data, so we get away 
with storing four brightness values and one co- 
lour set, rather than twelve values - four each for 
Red, Green and Blue. 


The single colour value could be encoded as an 
RGB triple but that would duplicate some of the 
brightness information, so it's more useful to con- 
vert the RGB into the equivalent HSV (Hue, Satu- 
ration and Value) or YUV {colour difference) triple. 
These are other ways of expressing colour in 
three parts, but here one corresponds to the 
brightness already measured for each compo- 
nent points, so we can discard that and end up 
with six numbers - two for colour and four for 
brightness. 


Raw colour images would require twelve num- 
bers, consisting of four triples, so we've achieved 
a 50 per cent compression and a better match 
with the physical properties of the eye, the CCD, 
the LCD display and the JPEG standard. 


Compression factors 


Other stages of JPEG compression depend on 
the original data and how aggressive the com- 
pression is. JPEG goes on to divide the picture 
into larger blocks, encoding these basic patterns 
and the differences between them. The variability 
comes from the way such differences are han- 
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died. Smaller differences are discarded to reduce 
the size of the compressed data. The quality fac- 
tor determines the trade-off between fidelity to 
the original and reduction in the file size. 


These Kodak cameras offer three compression 
settings: good, better and best - like burger 
chains, ‘small fries’ are not on the menu. These 
terms describe heavy, medium or light com- 
pression, resulting in small, medium or large files. 
Even then, the actual size depends on the subject 
matter, and if there's only estimated to be room 
for one more picture, it might not be stored at all if 
it turns out to be unexpectedly hard to compress. 


The disadvantage of packing is the need for CPU 
power on the camera, and processing time to 
pack each image, but this is more than out- 
weighed by the space saving. My DC200+ can 
easily squeeze 50 images onto a 4M flash me- 
mory card; without compression there would only 
room for four even at the lowest 640x480 pixel 
resolution in 24 bit colour: 307,200 pixels at three 
bytes each demand 900K per image. A 32Mb 
card now costs about £20 and can store 400 
images - it only takes a few seconds to swap 
cards, and the contents are retained indefinitely 
even if the card is not plugged into the camera. 


- We have an excel 
lent free decoder 
for JPEG images, 
Photon by Dave 
: This 


com- 
It's obvi- 
_ ously quite slow 


. pay on a standard QL 

about 50 pictures in compressed taki inut 
JPEG format, 640 by 480 pixels in 24 ( aking minutes i) 
decode a_ ful- 


bit colour 

screen image) and 
limited in colours but the faster your computer 
and the more colours you can display, the better 
Photon performs. 


What works 


The driver is written in SuperBASIC with a couple 
of machine-code extensions that are not essen- 
tial but help to speed it up. All the software is 
open-source. The main program allows users to 
download pictures from the camera and tell it to 
take and store a picture, with SuperBASIC com- 
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mands. George Gwilt is working on a menu-driven 
Turbo-compiled front-end for the driver, which will 
support QPTR without forcing its use, but the 
BASIC program is already quite usable by typing 
commands or stringing them together in scripts 
of your own. 


Compatibility 


The driver is Known to work with Kodak DC200, 
DC200+, DC210, DC210+ and DC215 cameras. 
These were produced over the last couple of 
years and are quite easy to obtain, though they 
are no longer current models. The same software 
protocol is used by other Kodak cameras, with 
minor variations (synthetic names are used to ac- 
cess images, rather than internal index numbers) 
so the DC240 and DC280 and recent models like 
the DC3400 and DC5000 should also work. 


The older DC50 and DC120 are also based on 
this protocol, and a few lines of BASIC should get 
them working too - if 
you have one of those 
and want details of the 
changes, please email 
me at 
qdos@studio.co.uk 

There is some support 
for them in the driver 
but it’s not complete or 
tested as so far no one 
with one of those ca- . 
meras has contacted 
me. 


There are hundreds of 
models of digital came- 
ras, and dozens of in- 
compatible © communi- 
cation protocols used 
to link them to computers. | wrote a detailed 
comparison of the protocols, including some of 
the general information in this article, for the 
December 2001 issue of Linux Format magazine, 
on pages 49 to 55. 


used from Qdos 


A lot of cameras use the so-called Universal 
Serial Bus or ‘USB’, and since there is no interface 
for this from Qdos-compatible systems they are 
physically incompatible with Qdos. The problem 
with interfacing USB with Qdos is that the com- 
plex chips that control USB from the computer 
end are all made for Intel's 32 bit PC! bus - even 
Apple Macs use those, but PCI has nothing in 
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This self-portrait was taken at the Quanta AGM, using Simon 
Goodwin's DC200+ to photograph the identical model Darren Branagh 
snapped up for £80 second-hand when he heard that it could be 


common with current Qdos-compatibles and the 
hardware effort needed to support USB directly, 
let alone the software, would be very great 
(please prove me wrong, Nasta). However there 
are two interfaces that do work - RS-23? serial 
and Compact Flash. 


The first thing to check is that the camera has an 
RS23? serial port - USB-only cameras are not 
going to work with Qdos, though if they use com- 
pact Flash storage you might be able to connect 
them via IDE. The part numbers matter as well as 
the brand, as cameras in each range may use 
Compact Flash, MMC, or Smart Media cards, and 
Kodak alone use three different serial protocols. 
Their DC220, 260, 265, 290 and DC4800 all use 
Digita drivers, based on a different and incompati- 
ble protocol. The new and heavily-advertised 
Kodak DX models are based on another protocol, 
PTP which is public but currently only defined for 
USB. 


The serial port interface is directly supported by 
my Digicam driver. This gives the greatest control, 
as it can issue com- 
mands to read and ad- 
just internal camera 
settings, but it's not 
very fast - even the 
smallest images take a 
few seconds to down- 
load, and large ones 
“may need a minute or 
more. 


Compact Flash 


and IDE 


But if all you want to 
do is read pictures 
from the camera into your expanded QL, 
Compact Flash is a good standard to look for, as it 
bypasses the camera's communication protocol. 
Cheap adapters like those offered to QL Today 
readers by Phoebus Dokos (QLT Volume 6 issue 
5, page 8) connect the Compact Flash cards uses 
as removable storage by many cameras, not just 
those from Kodak, to an IDE interface. 


You can then read the images on the memory 
card as if they were files on an MSDOS formatted 
hard disks, using Qubide, Q40, Q60, or an Amiga 
600, 1200 or 4000, all of which run Qdos Classic 
and use the same Qdos hard disk format as 
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ee endent QL Users Group 


Worldwide Membership is by subscription 
only, and offers the following benefits: 
Monthly Newsletter - up to 40 pages 
Massive Software Library - All Free ! 
Free Helpline and Workshops 
Regional Sub-Groups. One near you? 
Advice on Software and Hardware problems 
Subscription just £14 for UK members 
Overseas subscription £17 


Barclaycard: Visa: Access: Mastercard 


*Now in our Nineteenth Year* 


Further details from the Membership Secretary 


John Gilpin, 181, Urmston Lane 
Stretford, Manchester, M32 9EH 
Tel. +44(0)1618 652872 


or 
Visit the Quanta Web Site 
http://www. quanta.uni.cc 
email: quanta_membership @ uk2.net 
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Qubide. These JPEG files can be loaded directly 
into Photon - all you need is a program like Disc- 
Over to read the MSDOS directory from Qdos, or 
MTOOLS or CrossDOS which comes free with 
Linux and AmigaOS respectively. Many cameras 
support Compact Flash storage - not just ones 
from Kodak, but Agfa, Fuji, Polaroid and others, 
too. 


Compact Flash memory can be directly accessed 
at the speed of your IDE interface, but you have 
to swap the cards between systems and cant tell 
the camera to take pictures for you, or adjust 
settings from BASIC. 


Qdos Software 


DIGICAM_BAS is a 13K SuperBASIC program. 
The latest version is 1.6 and incorporates an im- 
provement designed by Phil Stokes which means 
that even if the Qdos 
system is not able to | 
keep up with the serial 
link all the time it can 
recover and re-request 
blocks of data if it finds 
that some are partly lost 
or corrupted. This makes 
it much more reliable on a 
slow or busy system. 


Even so, you need a fast 
serial port, capable of 
reading a block of just 
over 1K of data without a 
pause at least some of 
the time. The standard 
Sinclair one can never 
manage this - periodically 
it asks the sender to stop 
while it transfers data 
elsewhere, and as the 
camera uses only three wires - one to send, one 
to receive, and one for earth with no 
‘handshake’ lines to pause communication, it is 
sure to over-run. 


However the driver does work with most expan- 
ded Qdos-compatible systems, including Ataris, 
Amigas, Q40s and Q60s with Qdos and SMS, and 
a standard QL boosted with SuperHermes. It 
should also work with emulators like UQLX and 
QPC, as long as the underlying OS and serial port 
hardware does not get in the way. 
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This photograph of Roy Wood and Jochen Merz was 
taken by typing the command SNAPSHOT into SBASIC on 
Jochen’s Atari TT after a few tweaks to the DIGICAM 
driver program to suit the Atari's fast SER4 port. 


The speed of the connection and hence the rate 
at which pictures are downloaded depends on 
the speed of the computer Even a basic 68008 
QL with SuperHermes can connect, but only at 
9600 baud, around 1K per second - even so, this 
will load most pictures faster than they can be 
decoded by Photon on an eight bit QL. A Gold 
Card or Super Gold Card is a more practical pro- 
position, loading at over 5K per second via 
SuperHermes. This is quite a usable system. 


A Q40 or Q60 can manage 115,200 baud, the top 
speed for the camera, shifting over 10K per 
second. Ataris and Amigas manage rates from 
19200 baud for a basic 68000 system, up to 
57600 baud for accelerated 32 bit Amigas and 
Atari TT's. The driver was originally tested with 
Qdos Classic on several models of Amiga, as the 
interface and interrupt handler are fast enough to 
keep up with the uninterrupted flood of data from 
the camera, and then adapted for the QL when 
Tony Firshman kindly provided a SuperHermes. 
The Atari tests were per- 
formed on Jochen’s machine 
at Quanta’s AGM in Portis- 
head, and documented in the 
June 2001 issue of the Quan- 


ator for Linux and Unix sys- 
ems, on cheap IBM clone 


were to specify “serlir’ (to be 
on the safe side) as the serial 
device, and a slight tweak to 
the REBAUD procedure, simi- 
lar to that needed for Super- 
Hermes, to embed the new 
baud rate in the OPEN string when stepping up to 
115200 baud or other rates. 


It works flawlessly at that soeed on my Linux box, 
a K6/2-500 with Aladin AGPset motherboard, and 
| expect it will work well on anything with a buf 
fered serial port under Linux, eg. a 16550 or bet- 
ter standard on PCs since they started using 
modems. The tweak gets around the upper limit 
of 19200 bits per second on the standard Sinclair 
BAUD command. 
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Functions 


A few Turbo Toolkit commands and two new 
SuperBASIC extensions =are ~—sused___siin 
DIGICAM_BAS: assembler source is available for 
both, if you're interested, and none of them are 
essential - they just shorten and speed up the 
program a bit. CHEXOR% is a function that scans 
a string and combines all the bytes in if, using an 
exclusive-or function. This is the recommended 
method to check that data from the camera has 
arrived without corruption - the result is always 
the same if all the bits have arrived unscathed. 


Originally this was done in SuperBASIC, which 
was quite bearable on my 68060 Amigas, but the 
overhead of slicing out each character and doing 
arithmetic on its code was substantial, even on a 
68040, and on my Gold Card | found the check- 
sum was taking more time than the data transfer, 
till | recoded it in 
assembler 
Claus Graf 
found that his 
Q40 linked to a 
DC215 at 
115200 baud | 
was 14 times | 
faster with | 
CHEXOR% 
taking 24 se. 
conds instead 
of 33 to read a... 
230 KB JPEG 
image. The 
whole — exten- 
sion is just 90 
bytes long, in- | 
cluding name B® 
table and name 
list initialisation. 


1iS268 
Hew baud rate = 


The other new 

function is a 

variant of 

INPUTS and INB ; 
DIY Toolkit, and other extension packages. Like 
those it performs the equivalent of multiple 
INKEY$ calls from a channel, reading a specified 
number of bytes with a single call. Like INKEY$, 
but unlike the other toolkit commands, INBYTES 
supports a timeout parameter so it can read lots 
of bytes at once but if the data does not arrive 
after a specified amount of time it returns with 
what it can get, rather than waiting indefinitely. 
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This little tweak has taken several tries to get 
right, with help from George Gwilt, and makes 
DIGICAM_BAS much more resilient - Phil Stokes 
has also helped by working out how to get the 
driver to recover automatically if it gets out of 
sync, so it works even if badly-behaved programs 
or device drivers periodically block access to the 
serial port, reloading the 1K block till it arrives 
complete and with the right checksum. 


Before you type RUN you need to check that the 
camera is switched on, and set to CONNECT, and 
that the wire from the camera to the chosen 
serial port is connected at both ends. The 
standard QL serial port is not capable of coping 
with the large blocks of data from the camera, but 
SuperHermes fixes that, and most later compu- 
ters can cope as long as their operating system 
doesn't interrupt the data flow. 


You do have to 
make sure that 
flow-control 

handshaking 

and _ transla- 
tions are 
turned off, and 


name 
to select 
speeds _be- 
yond the limit 
of — Sinclair's 


| QL-compatibili- 
y of your sys- 
tem. The code 
to set the port 
and speed is 
isolated in the 
program to 
make it easy to change, and even if your platform 
is not yet tried you should only need to add or 
change a few lines to make it work, hardware 
permitting. 


Commands 


When you run the program it opens the serial 
port on channel #3 and uses the STATUS 
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PROCedure to tell you how many pictures are in 
the camera, and other information. After that you 
can issue commands like IMAGE, GET_PICTURE, 
REBAUD and SNAPSHOT to control the camera. 


The very simple PROCedure SNAPSHOT will 
take a picture, and display dots while it awaits 
compression to be completed. This calls another 
procedure SEND1 to send a command, code 124, 
to the camera, and then waits for a status byte 
from the camera. This can have one of four 
values - ACK once the command has been ac- 
cepted, BUSY while the image is being com- 
pressed, then DONE when the command is com- 
plete or SORRY if the camera was unable to store 
the picture - probably because it ran out of space. 


You can use the STATUS command to check that 
there's room before taking a picture, and IMAGE 
to find out the size of a given JPEG inside the 
camera and the settings when it was taken. At 
the moment this uses an index number which 
changes when pictures are deleted, but if we add 
support for the cameras that only use filenames 
(like the DC240, 280 and 5000) you'll have to 
specify a name like DCP02912.JPG, which won't 
change once the photo has been stored. George 
Gwilt is investigating these tweaks at the 
moment, but helo would be very welcome. 


IMAGES gives details of all the pictures in the ca- 
mera's memory, in a scrolling list. You can redirect 
this to a file with the DIY Toolkit USE command, 
which is how | grabbed some of the examples for 
this article. 


GET_PICTURE reads an image from camera, 
given the index number (currently) or potentially a 
synthetic filename, while GET_ALL is a bulk 
downloader that reads all the pictures to the 
default device (e.g. WINI_) while you get on with 
something else. 


REBAUD n% adjusts the serial port speed to n% 
baud - the cameras support rates from 9,600 up 
to 115,200, and the faster you can use, the better. 
Some experimentation may be needed to find the 
best rate for your system. If DIGICAM_BAS re- 
ports errors at 115,200 baud try lower rates till it 
works reliably, 


You may need to unplug the camera end of the 
cable, switch it off and switch on again if it get 
stuck in the middle of a data transfer After this 
DIGICAM_BAS should resynchronise automatical- 
ly when you re-run the program. Initial communi- 
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cation is at 9.600 baud, but that’s rather slow for 
image downloading. 


STATUS displays the current camera settings. 
Most of these can be changed with messages 
from the QL - you can even reset the Camera's 
clock, or (perhaps more usefully) set your QL 
clock from the Kodak one. The key routines to do 
this are in the SuperBASIC but you may need to 
add lines to call them with appropriate ‘operation 
codes’, depending on what you want to tweak. 


The accompanying table 2 shows the output 
from STATUS. If you type CONTINUE after getting 
STATUS you'll see the details of all the images on 
the current card - an example is in table 1. 


Table 1 - Results from the IMAGE 3 command: 


Picture number 3 is in JPEG format 

Taken at 1999 Dec 31 23:53:58 on a DC200 
Light level was measured as 6.5 LV 

Flash was selected but not used 

Exposure time was 31250 microseconds - 


aperture f40 

Compressed image quality is better 
Resolution is 640 by 480 pixels 

File DCP02912 JPG contains 73376 bytes 


This table shows details stored with a single 
image in the cameras memory, as printed by 
SuperBASIC after an IMAGE command. 


Table 2 - Results from the STATUS command: 


Camera time 2002 Apr 03 07:46:52 
Flash charged 

Image quality is better 

Resolution 640 by 480 pixels 

626 pictures taken 

359 flashes fired 

93 pictures stored in camera 

Good quality free capacity 5 
Better quality free capacity 3 

Best quality free capacity 1 
Battery status medium 

File type for new images is JPEG 
Camera model is DC200 

Video format is PAL 

Flash mode Is automatic 

Exposure compensation is automatic 
Automatic delay timer is off 


This table shows the current settings of the 
camera, as discovered by typing the STATUS 
command in SuperBASIC. 
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Listing - The CHEXOR extension 


* QDOS DIGICAM PROJECT — CHECKSUM EXTENSION CHEXOR 
* Version 1.0, Copyright May 2001 Simon N Goodwin. 
* Function returns byte result of exclusive or—ing 
* all the character codes of a string together - a 
* Kodak digital camera driver optimisation. 


start 


* result% = 


chexor 


define,al 
$110.w,a2 
(a2) 


lea 
move.W 


jmp 
CHEXOR% ( name$ ) 


$116.w,a2 
(a2) 

bad_exit 
#1, 43 
bad_param 
0(al,a6.1),d1 
bad_param 
O(al,di.w),a0 
#0,d1 

scan 

#1,a0 


movea.W 
jsr 
bne.s 
subq.wW 
bne.s 
move.W 
ble.s 
lea.l 
btst 
beq.s 
addq.1 


BP.INIT vector 


Vector to get a string 


One's enough, eh, Ingo? 


String length 


Work out result offset 
Is length odd? 


Round up for odd byte 


* Accumulate checksum in D3 as it's conveniently empty. 
* Note that EOR does not support the memory—to—register 
* addressing mode, doe to the way Motorola shoehorned 

* it in to the 68K instruction set. Unlike AND and OR, 
* it has to share its opcode prefix group... 


scan 


return_d0 


bad_param 
bad_exit 


define 


The CHEXOR% extension assembles to just 90 bytes of code that 
make digital camera input checking a lot faster. 


2(al,a6.1),d0 
dO, d3 

#1,al 

#1,d1 

scan 

a0, $58(a6) 
a0,al 
d3,0(a6,a1.1) 
#3, 04 

#0,d0 


move.b 
eor.b 
addq.1 
subq.1 
bne.s 
move.1 
movea.1 
move.W 
moveq 
moveq 
rts 
moveq #-15,d0 
rts 


0,0,1 

de.w chexor—* 
de.b 7, 'CHEXORS' 
de.w 0 


de.w 


end 
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Fetch the datum 
Mash it in directly 


Update BV.RIP 

Placate Turbo 

Stack the result 

Type = 16 bit Integer 
No run-time error 


BAD PARAMETER error 


No procedures, i FN 


"string" 


Other commands include 
FINISH, which closes the 
connection to the camera so 
you can use the port for 
something else, SHOW_MENU 
which displays a brief sum- 
mary of commands, and 
LOOK which displays an 
image file, using the Photon 
extension PHOT. 


By default this uses your 
current screen resolution 
and colours, but you can 
easily select another MODE 
in the procedure or add pa- 
rameters to change the way 
Photon handles colours, ad- 
justing the dithering or forc- 
ing a grey scale. This gives 
good results, better than 
newspaper quality with a 
mono monitor If you have a 
colour screen but want extra 
grey scales the PROCedure 
AMIGREY reprograms the 
Amiga palette accordingly - 
something similar should be 
possible on other emulators. 


Conclusion 


The driver does everything | 
want now, though as all the 
program source is _ freely 
available | hope that others 
will adapt and extend it to 
meet their own special 
needs. Several of the people 
who have helped me test it - 
and in some cases gone out 
and bought cameras just to 
do so! - are accomplished 
QL programmers, but as the 
driver is almost entirely writ- 
ten in BASIC, and details of 
the protocol are freely avai- 
lable, you don't need to be a 
software expert to custo- 
mise the program. 


Please let me know how you 
get on - but don't ask me for 
recommendations about ca- 
meras not mentioned, be- 
cause I've explained what | 
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know - and if manufacturers 
dont give out details to 
make their cameras usable, 
we should not be sup- 
porting them. 


All the photos accompanying this 
feature were originally captured 
on the DC200 and downloaded to 
Qdos Classic. After cropping to 
remove irrelevant borders and 
backgrounds, the full-colour JPEG 
files delivered to QL Today for 
printing ended up the following 
sizes: 


CompactFlash card 4,698 bytes 


DC200+ self portrait 7,673 bytes 
Roy and Jochen 19,762 bytes 


The Serial QL... 


Sinclair QL 
+SuperHermes 
Amiga 500/600 
Amiga 1200/4000 
Atari ST 

Atari MegaST 
Atari TT 
Q40/Q60 

Linux 

QPC 


9,600 
57,600 
19,200 
57,600 
19,200 
38,400 
57,600 
115,200 
115,200 


by Dilwyn Jones and Tony Firshman 


Q. How do | wire up a cable to 
connect QL and PC via the 
serial ports to do file transfers? 


A. Thanks to Tony Firshman 
(from whom you can purchase 
ready made cables) for the 
information to answer — this 
question. 


The tables below show the pin 
numbers for the British QL 
6-pin serial ports and PC COM 
ports with 9 pin and 25 pin D 
connectors. 


According to the QL manual, 
SER! is configured as a DCE or 
Data Communications Equip- 
ment. In essence, SERI is wired 
as though it was a modem. 
SER2 meanwhile is wired as a 
DTE or Data Terminal Equip- 
ment, in essence it’s wired as a 
computer serial socket! The 
inputs and outputs are if effect 
Swapped over despite the 
rather confusing labelling in the 
Communications: © RS-232-C 
section of the Concepts part of 
the QL User Guide. In terms of 


QL CABLE PC 


COLOUR 


4 (DTR=RTS) 


4 (DTR=RTS) 5 (CTS) 
1 


1 
N/A N/A 
N/A N/A 


SIGNAL 


NA means Not Applicable, the QL does not have DSR and DTR. The 
so-called DTR on a QL SER1 and SER2 pin 4 is actually more of an 
RTS as shown above by DTR=RTS. It certainly makes wiring easier if 
you think of QL DTR as being an RTS. 

~» and «- denote signal directions. 
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Table 3 - Computers, systems, speed limits and serial port setups 


Computer CPUbits Top speed _Serialport QDOS 


Sinclair/ 
Minerva 
Classic 
Classic 

SMS 

SMS 

SMS 

serl/2 Classic/SMS 
ser/2/3/4 — Sinclair 

? SMS 


ser3 
ser3 
serl 
serl 
serl 
ser2 
ser4 


This table shows the ports and perfomance of systems running 
DIGICAM_BAS Results for QPC, Thor QXL and Mac are solicited. 


connecting computer to 
computer since SERI is 
effectively wired as a modem, 
it may be easier to visualise 
using SER2 instead. 


Table 2 shows the QL serial 
ports pinout. Does anyone 
have this information for a QL 
such aS a Samsung unit with 
German or American 9 pin QL 
connections which we can add 
to this article? 


If you think of QL to 25D by pin 
number, then serl is ‘straight 
through’ (RxD to RxD, TxD to 
xD and so on, and ser2 is 
“crossover (RxD to IxD, TxD to 
RxD and so on). That is always 
my starting point, and all the 


rest can be derived from that. 


The P-Word... 


To connect two PCs with COM 
ports running QL emulators for 
example (e.g. to use SERNET) 
you will need a _ crossover 
cable with handshake wires 
connected as shown in the 
diagram below. This may also 
work on QL-compatibles with 
serial ports wired the same as 
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Table 2 


| SER1 (DCE) 
pin name function 

Signal ground 
input 

output 

ready input 
ready output 

+12 volts 


GND=Signal ground (common) 
TxD=Transmit Data 
RxD=Receive Data 
RTS=Request To Send 
CTS=Clear To Send 
DTR=Data Terminal Ready 
DSR=Data Send Ready 


SER2 (DTE) 


function 


signal ground 
output 

input 

ready output 
ready input 
+12 volts 


DTR=RTS 
CTS 


The whole diagram above is QL <-» PC only of course. 


If you are experiencing 
difficulty getting transfer to 
work reliably, start with a 
low baudrate. If short 
transmissions at low baud 
rates seem to work, this can 
indicate a handshaking 
issue. Try to establish the 
correct wiring for proper 
serial handshaking and 
(software permitting) you 
should be able to establish 
successful connections. 


Sernet Users 


The above cabling should 
work for a two computer ser- 
net link system. With more than 
two computers, you need (a) 
cabling which operates as a 
loop - third computer loops 
back to first for 3 computers 
for example and (b) a suitable 
sernet extensions file (some 
versions of Sernet only allow 
use of a two computer sys- 
tem). 


Sernet requires split input and 
output serial port drivers, the 
so-called SRX and STX receive 
and transmit drivers. These are 
normally only available in 
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Table 3 


9 PIN COM 25 PIN COM SIGNAL 


CTS-RTS 
RTS-CTS 
GND-GND 
DSR-DTR 
DTR-DSR 


SMSQ/E, although by using 
Hans-Peter Recktenwald’s 
SimSer extensions (available 
for download from 
http://www.soft.net.uk/dj/ 
software/other/other.html 
for example) such serial port 
drivers can be implemented 
from QDOS too (thanks to 
Derek Stewart for that tip). 


For more details of how to use 
Sernet, refer back to Volume 5 
Issue 1 page 32 of QL Today. 
Sernet software is supplied by 
Jochen Merz Software and can 
be found on most SMSQ/E 
master disks (ATARI, GoldCard/ 
SuperGoldCard, QXL and QPC 
1 and 2). 


the PC COM port equivalents, 
eg. some Auroras were sup- 
plied with PC style serial 
connection leads. The follow- 
ing lines should be connected 
where they exist: 


RxD~TxD 
TxD-RxD 
CTS-RTS 
RTS-CTS 
DTR-DSR 
DSR-DTR 
GND-GND 


On computers which don't 
have DTR and DSR, leave them 
unconnected, in most cases it 
will work fine without them. 


9 PIN COM 25 PIN COM 


A final hint from the publisher: 
| have lots of serial cables, con- 
nectors and adaptors to be 
able to connect every serial 
device with another serial de- 
vice. Several were bought 
ready-made, several | soldered 
myself. | have always found that 
a serial tester with dual-colour 
LEDs is more than helpful. 

Plug it between a_ working 
connection, open the port, 
send some data, close it and 
see how the LEDs change. 
Once you have an idea what 
the LEDs should look like, you 
will find it easy to make up own 
cables or set up new connec- 
tions. Serial testers don't cost 
much, and they can and will 
Save you so much time! 
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Hints and Tips 


1. Larger Editing Windows 


Q. Is it possible to increase the area of the 
window used for editing BASIC programs? | dis- 
like having to edit programs in a small box in the 
top left of a high resolution screen and would like 
it if there was a command fo enable BASIC pro- 
grams to be edited using the entire screen, 


A. Yes, the LIST EDIT and ED keywords can all 
cope with large windows. Since you are using 
high resolution screens, Il assume you are using 
SMSQ/E. If you were happy with the size of 
windows but wanted them away from the top left 
of the screen, It is possible for the WMON and 
WTV extensions to have offsets, to move the 
windows away from their normal position. For 
example, 


WMON 4,50,50 


will act like a normal WMON 4 command, but the 
windows will be at a position determined by the 
two numbers after that, in case 50,50. Of course it 
is easy to issue three WINDOW commands to 
enlarge the windows, but this is tedious and you 
have to remember the different sizes for each 
window in each screen resolution. 

Back in the mists of time (well, QL Today Volume 2 
Issue 3 actually) | wrote a set of extensions called 
DISPLAY_CODE which returned the maximum 
sizes of a window. FLIM_W(0) and FLIM_H(#0) 
are functions which tell you the largest size the 
#Q window could take (the full screen size). 
SBASIC also has the equivalent SCR_XLIM and 
SCR_YLIM functions. 

It is then a simple matter to write a small BASIC 
procedure you can add to the end of your BASIC 
programs to calculate the window sizes needed. 
lf you do not have the FLIM_W and FLIM_H 
extensions, simply use SCR_XLIM and SCR_YLIM 
instead - | used FLIM_W and FLIM_H to enable 
the procedure to work on QDOS systems with 
pointer environment as well. OUTLN is an exten- 
sion for setting the saved outline of windows, 
some systems may not need this. 

The OUTLN extension is present in SBASIC and 
also supplied in many toolkits and pointer driven 
software packages - QMenu has an OUTLN_rext 
extension for example. If it gives a ‘bad name’ or 
similar error, try removing line 1010 to see if it will 
work without it. 
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1000 DEFine PROCedure XIV 

1010 OUTLN #0,FLIM_W(#0) ,FLIM_H(#0),0,0 

1020 WINDOW FLIM_W(#0), FLIM_H(#0)-52,0,0 

1030 WINDOW 

#2, FLIM_W(#0) , FLIM_H(#0)-52,0,0 

1040 WINDOW #0,FLIM_W(#0) , 52,0, FLIM_H(#0) 
—52 

1050 BORDER #1,1,255 : 
BORDER #0,1,255 

1060 CLS : CLS #2 : CLS #0 

1070 END DEFine XTV 


BORDER #2,1,255 : 


Because | normally use the TV mode windows for 
BASIC program editing, I've based this routine on 
the assumption that #1 and #2 will use the same 
area of screen. if you prefer monitor mode win- 
dows, modify line 1020 to set #1 to use half the 
screen width, halfway across the screen and 
1030 to use half the screen width on the left of 
the screen: 


1020 WINDOW FLIM_W(#0)/2,FLIM_H(#0)-52, 
FLIM_W(#0) /2,0 

1030 WINDOW #2,FLIM_W(#0) /2,FLIM_H(#0) 
-52,0,0 


2. Type in Text 


Q. | would like to send some text from a program | 
have written directly into another program as 
though it had been typed into that program - how 
can | do this? 


A. Several toolkits have their own extensions 
such as TYPE_IN to do this. However, if you do 
not have one of these extensions, or it does not 
work on your system (many such extensions do 
not work properly on pointer environment sys- 
tems due to the way PE manages keyboard 
queues etc), it is possible to use the stuffer buffer 
of the hotkey system to transfer small amounts of 
text. 

The QPAC2 manual has a wonderful example, a 
short two line compiled BASIC program which 
can insert the date string into any program on 
page EE44 of the manual, based on a short 
program like this: 


100 HOT_STUFF "string" 
110 HOT_DO " " : REMark one space inside 
the quotes 


Line 100 inserts the string into the stuffer buffer, 
then line 110 pretends that ALT SPACE has been 
used to extract the string from the stuffer buffer 
The keyboard queue needs to be switched to the 
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DILWYN JONES 


QL P.D. SOFTWARE LIBRARY SERVICE 


THE TOP 10 PACKAGES! The QL PD Library consists of: 


Over 60 disks assorted PD programs 
15 disks with over 100 games in all! 
QL manuals and information on disk 
QL Hackers Journal & ClubQL e-zines 
46 disks of QL screens clipart 

26 demos of commercial QL programs 
Back issues of QL Today cover disks 
QL emulators for several computers 
Loads of Line Design clipart and fonts 
Loads of classic literature on disk! 
Lots more than | can list here! 

Just £1 per disk (or 75p if you supply 
disk) plus postage — see below 
Catalogue available — see below 


GE01 - Turbo Compiler 

L102 — CIA World Factbook (5 disks) 
GE51 — The Editor 2000 (2 disks) 
GE53 — Atapi/CDROM package for 
Qubide, Q40 to access CDs (2 disks) 
GA01 — Solvit Plus word games (2 
disks) 

GE25 — DIY Toolkit (3 disks) 
GE13/14 — QL Info-Unzip/Zip (1 disk 
each) 

GE32 — C68 Compiler (6 disks) 
GE03 — TurboPTR (2 disks) 

GA05 — Radar, Flightdeck demo and 
QL War game packages 
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For a PD software library catalogue, send me a formatted floppy disk, or an email requesting it to be 
sent to you by email, or download a catalogue from my website (address below). This PD library is 
run as a non-profit making service for the QL community. All programs in the PD library are PD, 
Freeware, or Shareware etc, also freely available from other libraries and websites, some also 
available for free download on my website where space permits. 


QL CD-ROMS 


QL DOCUMENTATION CD £5.00 - Vast collection of manuals, 
documents, articles, beginners information etc 
DJ PD LIBRARY CD £10.00 — My entire PD library on just one CD! 
QL EMULATORS CD £5.00 — All of the available emulators on one CD-ROM! 
QL PD-CDR £5.00 — Gérard Plavec's vast software collection. 
LINE DESIGN CLIPART CD £10.00 — Huge collection of Line Design clipart 
FAMOUS FACES CD £10.00 — Line Design pictures of the famous! 


QL RELIGION CD £10.00 — A collection of Bibles, religious texts, cliparts etc 
CD-ROMs supplied in {SO-9660/Joliet format (Rockridge by special request) for use with most 
systems able to access QXL.WIN media. Q40/Qubide 2 users may be able to use Thierry 
Godefroy's Atapi/CD drivers (disks GE53 in the library) to access these CDs. 


POSTAGE UK/Europe: add £1.00, Rest Of World: add £2.00, per order. 
PAYMENT In UK Pounds Sterling currency only please to avoid bank charges 
for currency conversion. Cheques payable to DILWYN JONES. 


Dilwyn Jones, 41 Bro Emrys, Tal-y-bont,Bangor,Gwynedd, LL57 3YT, U.K. 
Email:dilwyn.jones@dj.softnet.co.uk 
Website: http://www.soft.net.uk/dj/index.html 


Note: although run by the editor of QL Today,the PD library is a separate venture with no 
connection to the publisher of this magazine. Software is supplied free of charge, apart from 
copying and media charges etc to cover costs and without any warranty other than to the 
replacement of defective media. In other words, usual PD library terms. E & OE 
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right program, so your program needs to be 
either unlocked or have no open windows at the 
point this code is executed. 


Directory Deletion 

- update from David Denham 

Some time ago, | gave a little hint on deleting a 
single file or directory name in QPAC2, based on 
selecting multiple files and selectively deleting 


QLTdis - part 6 / 2 


Norman Dunbar 


The next routine is the start of the effective 
address decoding stuff | though that this would 
give me the most grief, but as it turned out, it 
was actually quite simple to do. Remember an 
effective address is part of the op-code and 


them to get around the fact that if you DO on a 
single directory name, QPAC2 tries to enter that 
directory rather than bringing up the commands 
menu to let you get at the DELETE command. 

In fact, there is a simpler solution. HIT the direc- 
tory name, then DO on a part of the files window 
which isn't a filename, in other words, right click 
on nothing. The commands menu now comes up, 
letting you remove the directory name (as long as 
the directory is empty). 


uses bits 0 to 5 to hold a register number and a 
mode number In this routine we simply extract 
these two from the op-code into DOW (the mode) 
and D1iW (the register) and then use yet another 
jump table to fire us off into another part 

of the code. 


[ee ee es =o 
* Effective Address decoding subroutine 


; Preserve DO.W 
; Has the size been set yet ? 
; Yes — already set 


; Get size in DO 
; Get size in D5 and restore DO 


Di will be the register eventually 

DO is the mode 

Keep only the mode bits in 3 - 5 

DO = mode * 2 = offset into mode_table 
Keep only the register bits 

Mode table address in A3 

Fetch the offset to the mode routine 
A3 now points at the mode routine 
Process the mode 

Restore DO 


eff_addr move.w 40,-(a7) : 
tst.w a5 ; 
bne.s ea_sized 3 
Move.w d0,d5 3; Save DO for now 
bsr size_d0d : 
exg d0,d5 ; 

ea_sized clr.l dl 3 
move.w d0,d1 3 
andi.w #$38,d0 ; 
lsr.w #2,d0 7 
andi.w #$07,d1 j 
lea mode_table, a3 ; 
move.w 0(a3,d0.w),d2~ ; 
adda.w 4d2,a3 ; 
jsr (a3) ; 
move.w (a7)+,d0 ; 
rts 

mode_table dc.w mode_0Q-—mode_table 
de.w mode_i—mode_table 
dc.w mode_2-mode_table 
dc.w mode_3-—mode_table 
de.w xmode_4—mode_table 
dc.w mode_5-—mode_table 
de.w mode_6-mode_table 
de.w mode_7—mode_table 


Here is the mode 0 routine — it deals with Data Register Direct addresses and simple adds ‘Dn’ to the 


buffer Start simple and work up ! 


KX _. a 
%* Mode 0 — Data register direct 


mode_0O bsr dddd ; Its data register direct 
move.w di,d4 ; Data register number 
bsr reg_no ; Must be 0 to 7 
rts ; Done 
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Another simple one for mode 1 - its Address Register Direct this time which simply adds ‘An’ to the 
buffer. 


mode_1 bsr aaaa ; Its Address register direct 
move.w da1,d4 ; Address register number 
bsr reg_no ; Must be 0 to 7 
rts ; Done 


Starting to get harder not, mode 2 's the Address Register Indirect mode, and adds '{An)' to the buffer. 


I ean a nnn ee a 


* Mode 2 — Address register indirect 


rE ce eS ae Se RS 
mode_2 bsr 1_bracket_a 3; Add '(A' to the buffer 

Move.w di,d4 3 regsiter number 

bsr reg_no 3; Add to the buffer 

bsr r_bracket 3; Close bracket 

rts ; Done 


Adding to the complexity, we have mode 3 - Address Register Indirect with Post-increment, which is 
basically, a mode 2 with a plus sign on the end - so guess how we decode this then? Correct - we 
call the mode 2 routine and add a '+' to the buffer Simple and effective. (Opps, sorry that pun was 
intended!) 


a a at ah a ae a Oe oe cee ee ee 
* Mode 3 — Address register indirect with post—increment 
ee a ee ee ee ao ES er eT Se ee eee ree nee 
mode_3 bsr mode_2 ; Pretend address register indirect 

moveq #'+',d4 ; And now the post-increment bit 

bsr str_add_b ; Add to the buffer 

rts ; Done 


Mode 4 gives us another chance to re-use some code. Address register Indirect with Pre-Decrement 
is a minus sign followed by a mode 2, so thats how we decode it. 


i i i Se Ne ed 


* Mode 4 — Address register indirect with pre—decrement 


xmode_4 moveq #'-',d4 ; First the pre-decrement bit 
bsr str_add_b ; Add to the buffer 
bsr mode_2 3; Pretend address register indirect 
rts ; Done 


I'm beginning to see a pattern developing here, mode 5 is ARI (| can't be bothered typing it all out 
again!) with a number in front. The number is a 16 bit displacement and has to be extracted from the 
word that follows the op-code. Then, we call our mode 2 routine again to get something like ‘dddd(An} 
in the buffer. 


Nn ON a 
* Mode 5 — Address register indirect with displacement 
a es Na 
mode_5 bsr dollar ; Hex addresses need a dollar 

move.w (a6)+,d4 ; Fetch the displacement 

bsr d4_hex_w ; Add to the buffer 

bra.s  mode_2 ; Pretend address indirect mode 


Ah well, it had to end sometime. No more mode 2 stuff. Now we are into mode 6 which is Address 
Register Indirect with Index. This is something like mode 5 above but the displacement is only 8 bits, 
but we have an index register - which can be word or long sized to consider as well. This adds 
something like ‘dd(AnRx.size) to the buffer 
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ah Ns oe 
mode_6 bsr dollar ; Hex addresses need a dollar 
move.w (a6)+,d0 ; Get the index & displacement data 
move.w 4d0,d4 
bsr d4_hex_b ; Add the displacement byte 
bsr 1_bracket_a ; Add '(A' to the buffer 
move.b di1,d4 ; Get the register number 
bsr reg_no ; Add to the buffer 
bsr comma ; Followed by a comma 
move.w d0,d4 ; Get the index data again 
bsr index_reg ; Add to the buffer 
rts ; Done 


Mode 7 is not a real mode, but a catch all for stuff not covered above. The register number we so 
carefully stored in D1W is not really a register number, but a sub-mode. The problem is that while there 
are 8 values possible in Di, only 5 are valid. If the register number is 5, 6 or 7 then it is an invalid 
mode. 


Once again, we simply use DiW as an offset into a table and jump into hyperspace again. 


a pa ee ag SO 
* Mode 7 — Select the sub-mode routines 

Ha eC ees nme 
mode_7 lea sub_modes, a3 ; Sub-mode table 


3 
move.w di,d2 ; Get the sub-mode number into D2 
lsl.w #1,d2 ; Offset into table 
move.w O(a3,d2.w),d2 j; Fetch the offset 
adda.w d2,a3 ; Calculate the routine address 
jsr (a3) ; Call the sub-mode address 
rts ; Done 


sub_modes  dc.w sub_mode0Q—sub_modes 
dc.w sub_modei—sub_modes 
dc.w sub_mode2—sub_modes 
de.w sub_mode3—sub_modes 
de.w sub_mode4—sub_modes 
dec.w sub_mode5—sub_modes 
de.w sub_mode6—sub_modes 
de.w sub_mode’7—sub_modes 


Sub-mode 0 is the absolute short addressing mode which simply adds ‘$aaaa’ to the buffer The word 
for the address is extracted from the word following the op-code. 


Yo me ee 
* Sub Mode 0 — Absolute short address 
Yo a i i ne et 
sub_mode0  —bsr dollar ; Dollar for addresses 

move.w (a6)+,d4 ; Get the short address 

bsr d4_hex_w ; Add to the buffer 

rts ; Done 


Sub-mode 1 is the absolute long address mode which adds ‘$aaaaaaaa’ to the buffer The long word 
for the address is extracted from the long word following the op-code. 


Ji nan i i! 
* Sub Mode 1 — Absolute long address 
Xe 
sub_modei bsr dollar ; Dollar for addresses 

Move.1 (a6)+,d4 ; Get the long address 

bsr d4_hex_4 ; Add to the buffer 

rts ; Done 
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Sub-mode 2 adds ‘Laaaaaaaa(PC) to the buffer and is of course, the PC with displacement addressing 
mode. 


On a ie a 
* Sub Mode 2 — PC with displacement 
a a eee 
sub_mode2 bsr ell Add 'L' to the buffer 


Get current PC address 
Add offset word (sign extends) 
D4 has the destination address 


move.] a6,a3 
adda.w (a6)+,a3 
move.1 a3,d4 


Mma Nee Ne re ee ee Ne Ne 


bsr d4_hex_4 Add to the buffer 
move.1 #'(PC)',d4 Some text 

bsr str_add_l Add it 

rts Done 


Sub-mode 4 is PC with index and is similar to the above, but involves an index register as well. As you 
may have surmised by now, the index register bit is handled by another sub-routine which will be 
described later This routine adds stuff like '_aaaaaaaa(PC. Rx.size)’ to the buffer. 


Fr ll eine eee eee sce 


* Sub Mode 3 — Program counter with index 
Saat SN EP A Se Sr 
sub_mode3 bsr ell Add 'L' to the buffer 
movea.1 a6,a3 ; Get current PC address 
move.w (a6)+,d0 Get index & displacement data 
move.w d0,d4 
ext.w d4 
adda.w 4d4,a3 
move.1 a3,d4 
bsr d4_hex_4 
move.l #'(PC,',dA 
bsr str_add_l 


Mee 


wee 


Extend the byte to a word 
Add to current PC address 
Ready for conversion 

Add to the buffer 

PC part of the instruction 
Add to the buffer 


Non Wwe We ee ee ee ee oe toe 


move.w d0,d4 Copy again 
bsr index_reg Call index register routine 
rts Done 


Sub-mode 4 is quite simple, but needs the value in D5W to be set to 1, 2 or 4 as per the decoding of 
sizes routine above. This value in D5W tells the following code how many bytes are to be extracted 
from the memory address following the op-code for the data. Long words (D5=4) need 4 bytes, word 
need 2 and bytes need 1. The value in D5W is the actual amount of data to be extracted. 


* Sub Mode 4 — Immediate data 


a 


sub_mode4 movem.w 4d0/d5,—(a7) ; Preserve DO and D5 
bsr hash_dollar ; some immediate hex data coming next 
3 
3 


empi.b #4,d5 ; LONG sized ? 
bne.s  s4_word ; No — try word 


Get the long data 
Add to buffer 
Skip 


Nee 


s4._long move.1 (a6)+,d4 
bsr d4_hex_4 
bra.s s4 done 


we 


seo 


Get the word or byte data 
Byte sized ? 


s4_word move.w (a6)+,d4 
empi.b #1,d5 


3 
3 
beq.s  s4_byte ; Yes, skip 
bsr d4_hex_w ; Add to the buffer 
bra.s s4 done ; Skip 
s4_byte bsr ad4_hex_b ; Convert the byte data 
s4_done movem.w (a7)+,d0/d5 3; Restore working registers 
rts ; Done 


3D 
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The comments for the remaining sub-modes routines explain it all - what more do | need to say? They 
all cause an error message to be logged to the output buffer showing the fact that a mode 7 
effective address was invalid. 


* is invalid for a mode 7 instruction so add 'M7,Rn «——-DATA ???' to the 
* buffer to indicate a problem. 


Kee a ea ee eR Re ee ee ee 
sub_mode5 equ * 

sub_mode6 = equ x 

sub_mode7 lea output+2,a5 Reset output buffer 


Reset the size as well 
; Mode 7 Register text data 
; Add to the buffer 
Move.b di,d4 Get the register number 
add.b  ='0',d4 ; Convert to a digit 


2 
moveq #0,d6 ; 
3 
2 
; 
a 
bsr str_add_b ; Add to the buffer 
, 
2 
3 
; 
3 
3 
; 


move. #'M7,R',d4 
bsr str_add_1 


move.1 #' <—',d4 ; D4 = 'space arrow! 
bsr str_add_l ; Add to the buffer 
move.1 #'DATA',d4 ; Text 

bsr str_add_1 Add to the buffer 
move.1 #' ??72',d4 ; More text 

bsr str_add_1 ; Add to the buffer 
rts Done 


This next routine is the famous index register sub-routine as used in a number of places above. It 
extracts the index register details - address or data - and size - word or long - from the word in 
memory, and adds it all to the buffer We generate stuff like ‘An.size) or ‘Dn.size)’ in this routine. 


tt ee 


* Index Register sub-—routine 

en a PUSS TTA ec SN eT 

index_reg  btst #15,da0 
beq.s ir_data 
bsr aaaa 
beq.s ir_reg 


Address or data ? 
Clear = data 

Do an address register 
Done 


Neo Se Nee tee 


ir_data bsr dddd Do a data register 


Mee 


ir_reg andi.w #$7800,d4 Keep bits 12 to 14 only 
lsr.w #8,d4 Shift bit 12 -» bit 0 
Isr.w  #4,d4 8 bits maximum though ! 
bsr reg_no Store the register number 


Check the size 
Clear = word 
Do long size 


btst #11,d0 
beq.s ir_word 
move.1 #'.L)',d4 


Nee ee we wee toe tee we ee 


bra.s ir_size Skip 
ir_word move.l #!'.W)',a4 ; Do word size 
ir_size bsr str_add_3 ; Finish the op—code 
rts ; Done 


A very simple routine next, which takes the value in D4 - which will be between O and 7 - and 
converts it into the ASCII digit for that value. This is then added to the buffer. 


XS a ee eet I a 
* Register number sub—routine. 
X—__ (renee a a a 
reg_no add.b #'0',d4 ; Convert d4 from 0 to 7 -— '0O' to '7! 
bra str_add_b 3; Add it ti the buffer 
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And _ finally. some small but perfectly formed 
routines which are called from a number of 
places to do a simple thing - to add one or more 
characters to the outout buffer 


When | was writing QLidis | found that | was 
writing some code more than once - and this Is 
a good sign that a sub-routine is needed. After a 
time, | ended up going through all the code | had, 
extracting all the sub-routines and counting the 
number of calls to them. Anything with 2 or more 
calls was extracted and added below here. 
Anything with one call stayed where it was. 


Note that rather than calling ‘BSR STR _ADD_x’ 


aa eli tt paicichlietca el 


and then adding an RTS’ instruction to the 
following routines, | simply ‘BRA STR_ADD_x'’ 
which saves me a few bytes for each routine 
and saves typing - when the STR-ADD_x 
routine gets to its own RTS, control returns to 
wherever it was when it called the routines 
below. 


This is quite a useful trick, but you have to know 
your code inside out before you can use it - 
because there will always be a place where it 
won't work due to something being on the stack 
above the return address - beware! 


On with the rest of the code. 


NOTE : 


DK FE OK OK OK OOK OK OK OK OOK 


comma moveq #',',d4 . 
bra str_add_b ; 
space moveq #!' ',d4 ; 
bra str_add_b ; 
dddd move.b #'D', dd ; 
bra str_add_b H 
aaaa move.b #'A',d4 3 
bra str_add_b ; 
ell move.b #'L',d4 ; 
bra str_add_b ; 
uu move.b #'W',d4 ; 
bra str_add_b 7 
dollar move.b #'$',d4 ; 
bra str_add_b j 
slash move.b #'/',d4 ; 
bra str_add_b ; 
r_bracket move.b #')',d4 ; 
bra str_add_b 3 
eight move.w #'08',d4 
bra str_add_w : 
comma_d move.w #',D',d4 7 
bra str_add_w ; 
comma_a move.w #',A',d4 F 
bra str_add_w ; 
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Some useful sub-routines to add certain character strings to the output area. 
These are here if they are needed two or more times. Names should be fairly 
meaningful ! 


These routines are all called by a BRS instruction. As they all end up 
calling another subroutine, the BRS to that routine has been replaced by a BRA 
which means that the return to the caller of THIS routine is from the routine 
called from here ! This saves me typing RTS for every subroutine AND saves two 
bytes and 16 clock cycles per RTS instruction AND the BRA instruction is 
quicker by 8 clock cycles too ! 


; Comma required 


Add it & return 


Space required 
Add it & return 


Data register required 
Add it & return 


Address register required 
Add it & return 


L size required 
Add it & return 


W size required 
Add it & return 


Hex data required 
Add it & return 


Slash required 
Add it & return 


Right bracket required 
Add it & return 


; Eight required 
Add it and return 


Comma D required 
Add and return 


Comma A required 
Add and return 
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space_d move.w #' D',d4 ; Space D required 
bra str_add_w ; Add and return 
space_a move.w #' At,d4 ; Space A required 
bra str_add_w ; Add and return 
dot_w move.w #'.W',d4 3; Size W required 
bra str_add_w 3; Add and return 
dot_ell move.w #'.L',d4 3; Size L required 
bra str_add_w ; Add and return 
j1_bracket_a move.w #'(A',d4 ; Address reg indirect ete required 
bra str_add_w 3 Add and return 
hash_dollar move.w #'#$',d4 ; Immediate Hex data required 
bra str_add_w ; Add and return 
comma_cer move.l #',CCR',d4 3 Move to CCR required 
bra str_add_1 ; Add & return 
comma_mba move.l #',—(A',d4 ; Guess ! 
bra str_add_1 3; Add & return 
iba move.1 #'-(A',d4 3; Guess again ! 
bra str_add_3 ; Add & return 
comma_sr Move.1 #',SR',d4 ; Move to SR required 
bra str_add_3 ; Add & return 
dot_s_space move.1 #'.S ',d4 3; Short branch ete required 
bra str_add_3 ; Add and return 


And there you have it. Type that above code into 
DISS_ASM and assemble the whole lot again 
and hopefully you will be able to disassemble 
some instructions in the type O to type 16 range. 


| have tested the routines for those and they 
work fine, so happy disassembling. 


See you next time for more exciting stuff 


QDT: A Progress Report 
Jim Hunkins 


O2:14:56 11372K) 


| am happy to say that, despite 
loosing a couple of months of ;--a=saeee 
potential development time 
recently, QDT Is progressing 
once again and getting 
interesting. 

Just to let everyone know 
where things stand now, QDT 
can at this moment execute | 
programs, open and update eek 
properties with tabbed proper- 

ty notebooks, and do some 

nice little things like move 

icons on the desktop and 


BG 
rename their text. And it is TT te 
evolving constantly. As | =e 
implement different pieces, | t E 
keep getting different ideas of [fFigure ifs) 
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how to do things and what 
features/capabilities should be 
included. The hardest part is to 
not try to do everything up 
front. | am getting in the habit 
of taking notes for many of my 
ideas. But some just can't be 
put off Oh, and yes, | do re- 
serve the right to change 
anything you see between 
now and when | ship this thing. 
In fact, at least one of the 
images you will be seeing here 
is scheduled for modification 
shortly. To give everyone a 
snapshot of what QDT is 
looking like now, | am including 
a desktop snapshot along with 
several clips from different con- 
figuration notebooks. Here are 
some notes to help you walk 
through the images. 


Figure 1 (previous page): QDT 
in Action 


This is the REAL thing. QDT 
has opened up, setup the 
icons on the desktop (upper 
right corner) and opened a 
folder (upper left side). The 
different things that are 
happening here are: 

t) | have started a game (lower 
left side) using "The Wall’ icon 
on the desktop. 

2) | have opened the proper- 
ties notebook {lower right side) 
for "The Wall’ icon and have, 
from the notebook page la- 
beled ‘IconExec’, decided to 
change the icon in use by 
pressing the "Make New” but- 
ton in the property notebook 
page. This opened the Icon- 
Draw program (center). Notice 
how the "Make New’ button is 
shaded? This means that the 
notebook is waiting until the 
button’s action is completed; 
ie. the IconDraw program clo- 
Ses. 

3} | also pulled down the menu 
from the left most icon on the 
desktop (top center) in order to 
do some action with it (such as 
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Open the folder rename the 
icon, or even delete it). Notice 
that the Resize option in the 
drop down menu is blocked 
out since the folder is not 
open and resizing doesn't 
make sense. 

4) | have also placed my cursor 
back over “The Wall’ icon 
again, but you will notice that it 
is locked out. While you can 
execute multiple programs 
from the same icon, once you 
open the property notebook 
for an object, you must close 
the property notebook before 
accessing that particular icon 
again. This makes sense be- 
Cause you normally would not 
change a property for some- 
thing while trying to use it for 
something else (take my word 
for it :). While this may look 
complex to some of you, it is 
all very easy. QDT is handling 
all the details. Everything is just 
a click or two away and very 
simple to work with! 


DD At Every a0T startup 

C At Hext @OT startup onty 

CO If Desktop has Changed 

1 Per number of Days 

D If sanuatty saving desktop 
Show archive status during startup 


Keep separate archives 


Figure 2: The QDT Desktop 
Archive Notebook Page 


Any desktop design must have 
an easy way to organize your 
daily activities and manage the 
basics of computer life. it also 
must provide a level of security 
in its use and basic system 
management. The QDT Desk- 
top has its own Properties 
Notebook which includes eve- 
rything from Archiving your 
desktop to handling startup 


options to managing screen 
resolution and screen savers. It 
will even give you system 
information without having to 
dig up a program that is buried 
some where on one of your 
disks. The archive page is a 
good example to look at. Using 
a combination of check lists, a 
rotating menu, and an ex 
clusive list, you have full control 
over when (and if} QDT ar- 
chives your current desktop 
setup, gives you a choice of 
how many archives to keep 
and where to put them, and 
allows you to recover (in case 
you just happen to erase one 
of those very important files!). 


ect Picondpen Potartup Varchive 
Desktop Startup File: [GpTStartup 


0 shou Desktop Object on Desktop 


Startup Notebook Page 


As with any program, you have 
a choice with QDT to configure 
lots of stuff (or to just leave 
everything as it defaults to if 
you wish). The Startup page 
gives you a quick view of what 
can happen when you start 
QDT You can run a separate 
fle which can run different 
programs automatically as part 
of the desktop start sequence. 
You can also choose whether 
or not to have QDT have its 
own icon (object) on the 
desktop (you will also be able 
to access QDT stuff from a hot 
key action if you don't choose 
this}. In case you want to setup 
your desktop for different 
activities or there are multiple 
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users On one machine, you can 
have different versions of the 
desktop. Of course to do this, 
you need to be able to save 
your desktop. In addition, there 
will be automatic save options 
for when you change things {or 
you can tell QDT to forget 
what you just did - handy at 3 
in the morning). To help you 
with your desktop creation, 
Desktop Builder {included with 
initial release) and Theme Ma- 
nager (to be released later) can 
both be launched from this 


page. 


Object YSesston Ulcantloced Yiconéxec YAssoctations BF 


Object Nawe: Wal t_exe 


tont = fwint_apps_games_ 


Config Block Name: Colours / Farben 
Config Block Vers: 1.00 
Object Type: Executable Fite 


Locations/Devices 


Bata Dir: wint_apps_qamas. 


Command Line: 


Program Dirt @ uin2_dev_cé3_ 


Output Devs 


Figure 4: The QDT Program 
Object Notebook Page 


This page occurs for all pro- 
gram, file and folder objects in 
one form or another It will al- 
ways give the name of the ac- 
tual object and where it exists. 
The config block information is 
pulled from the object automa- 
tically if it exists (if not, there 
will be text telling you that no 
config block was found. And 
the object type (Executable, 
File (and type), Folder etc) is 
given. All object types will 
have at least some of the 
Locations/Devices shown 
here. lf nothing is specified by 
you (or by the automated set- 
up during install}, the notebook 
will check for global properties, 
first within QDT itself and then 
system wide. Here, the Data 
Directory was actually speci- 
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fied but there was no Com- 
mand Line given (and no de- 
faults for it) Looking at the 
Program Directory line, you will 
note a small symbol (sd with an 
underline} just to the left of the 
text box with "win2_dev_c68_.”. 
The symbol means that the 
notebook is using a default 
value since it did not find one 
that you gave. In this case, the 
notebook did not find a QDT 
default value but did find a 
system global variable value 
for the Program Directory. You 
can also prevent this default 
choice by simply entering an 
empty string into the box. 


Doject YSession YiconCtased UleonExec YAssociations 


Object Open Behavior 


$0 Add pointer GUTLN 


Other 
Language: 


Figure 5: The QDT Program 
Session Notebook Page 


When a program is opened, 
there are different ways it can 
be executed. This page gives 
you control over this without 
having to remember all the 
ways to make these happen. 
First, you can tell QDT to al- 
ways use the same existing 
program if it already has been 
run (basically this will pick the 
program and put your cursor 
onto it). Or you can tell it to run 
a new copy everytime, regard- 
less. And note the “sd” symbol 
next to the check box. This 
again means that you did not 
make a selection so a default 
value is being used. The poin- 
ter environment has different 
things it can do to help with 
different types of programs, 


which are shown in the Pointer 
Env Behavior section. The 
notebook will try to figure out 
what kind of program you 
have, but you can always over- 
ride the value by clicking on 
one of the exclusive list but- 
tons on the right. You can also 
tell the system to setup a poin- 
ter QOUTLN for an older 
SBASIC program. And now for 
the change | hinted at before. 
Forget the Language piece - 
not very useful after all so | will 
replace it with some other cool 
stuff {visit my — website 
www.jdh-stech.com to find out 
once the change is in). 


Object PSessiton flconCtosed YlconExec (Associations 


256 Colors 


wt Hotebosk: Program 


Figure 6: The QDT Program 
IconClosed Notebook Page 


Fvery object needs a pretty 
icon, someone once said (OK, 
it was me a few minutes ago). 
And here is where you have 
control over what you have to 
look at. You can set the Icon 
text here, change the Icon 
(which is shown), and even 
pick a different size The 
modes available in the actual 
Icon file are shown for you 
convenience. And if you feel 
really creative, hit the Edit or 
Make New button to update 
the Icon itself If you aren't sure 
which Icon to use, hit the Find 
button to bring up an Icon 
Browser {on the list of pro- 
grams for later release}. The 
notes section will alert you if 
there was any problem and a 
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Im stillen Winkel 12 D-47169 Duisburg 
Tel. 0203 502011 Fax 0203 502012 
http://www.j-m-—s.com/smsq/index.htm 


SMSQZE Prices 


Due to changes in the licensing structure we are happy to be able to | 
reduce the prices for all SMSQ/E products! 


QPC2 Version 3 with SMSGQ/E 


New Version with complete manual EUR 99,90 


Upgrade to QPC2 Version 3 


From QPC1 (or just QPC - the first QPC!) EUR 69,90 
From QPC2 Version 1 (or just QPC2) EUR 44,90 
From QPC2 Version 2 EUR 20,40 


You will receive a new QPC part of the manual. Please return QPC master 
disk. Please note: QPC1 will not be supported on this disk anymore. If you 
want to continue to use QPC1, then please make a backup-copy of the 
QPC master disk before you return it to us. 


All other SMSQ/E 


for GoldCard/SuperGoldCard or QXL or ATARI 
price per Version EUR 49,90 


TERMS OF PAYMENT 
Postage and package [Germany] EUR 4,86 (if total value of goods is up to EUR 25,- then only EUR 3,32). 
[Europe] £4,50 / EUR 7,41 (if total value of goods is under £15 / EUR 25,56 then only £3 / EUR 4,86). 
[Overseas] between US$7.50 (1 item) and US$17.50 (maximum). 
Cheques in EURO and International Money Order in EURO (both have to be drawn on German banks). 
We accept Internation Reply Coupons as payment (can bo bought at any post office): 1 IRC = EUR 1.02 redeeming value 
Exact prices are given in EUR ... the price in £ and/or US$ are approx. conversion based on the 
exchange rate at the time of creation of this ad. Prices may be adjusted in case the exchange rate falls 
considerably out of this range in both directions! 
We can charge your credit cards in £’s, US$, EURO or in DM - please state the currency you prefer. 
Please do not send any UK bank cheques in £ - our banks have increased the fee for handling them 
by 600% (no joke!) so we cannot accept them anymore, unless you add £6 for clearing the cheque. 
E&OE. 


Hy 
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substitution was made (such as 
the color mode and size you 
requested didn't exist in the 
Icon File). 


Associated File Suffix: jexe 


Set to Default: 


Figure 7: The QDT Program 
Associations Notebook Page 


Many users use Filelnfo | cur- 
rently to allow associations 
between types of files and 
executable programs (IE: click 
on a file of a certain type, and 
a specific program is started 
with the file chosen loaded). | 
am happy to say that QDT will 
be allowed to use the Filelnfo 
system for its associations 
basis. The idea is that, for 
those who have Filelnfo setup, 
QDT will inherit the settings 
and allow the user to configure 
things either with the original 
Filelnfo or within specific 
notebooks. This page is just a 
hint of things to come and stil 
needs to be flushed out. 


Source Code to be availa- 
ble - the continuing story 


Wolfgang Lenerz 


I'd like to keep you informed of the state and 
Status of the publication of the SMSQ/E source 


code. 


The future licence-to-be has been a bit modified, 
notably to take into account the fact that test 
versions must be easily distributed. The (still pro- 
visional} text was published on Ql-users, and is 


as follows: 


Official statement 


1) This software, called SMSQ/E’, is copyright (c) 


FObject Session Ylcontlosed iconExec (Associations By 


Object Location: 


Object Nome: 


Config Block Name: Colours /¢ Farben 
Config Block Vers: 1.02 
Object Type: Executoble File 


GOT - Configuration 
teboot: Program 


Figure 8: The QDT Folder 
Object Notebook Page 


lf you noticed, this page does 
not have its text boxes all filled 
in. All of the Program Notebook 
Pages shown previously were 
generated live by QDI This 
one however is only partially 
implemented. What it means 
simply is that, while lots of pro- 
gress has been made, there is 
still tons of work left to do. OK, 
enough for the caution (ie. 
QDT is not shipping next 
week). On this page, you can 
see another detail of how 
things are being looked at. 
Folders in QDT can be ‘normal 
or ‘executable’. From the note- 
book page, you can literally 
switch back and forth between 
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the two types by simply pres- 
sing the Change button on this 
page. In this case, the note- 
book will then switch to the 
other type and let you enter 
the executable object name. 
etc. Simple. 
| should end this little update, as 
it is past 3 in the morning and | 
had promised it to Jochen on 
Sunday (yesterday technically). 
Since | haven't gone to bed yet, 
as an engineer, it is still Sunday 
to me. By the time you read 
this, | will have given a working 
demo of QDT as It stands on 
June 1 at the North American 
QL show. | expect my website 
www.jdh-stech.com will have up- 
dates about two weeks later 
with lots more than you see 
here. This will include a sample 
or two of some very nice cos- 
metic improvements to both the 
buttons and the actual win- 
dows in use (thanks to Marcel's 
recent work!). So stay tuned 
and feel free to drop me a note 
with suggestions, ideas, or 
whatever And thanks to those 
of you who have already writ- 
ten in, especially those offering 
their assistance and respon- 
ding to the questionnaire pu- 
blished recently. 


copying or use of the software, whether in 
binary or source code form, and/or its 
documentation is prohibited. 


SMSQ/E will be made available, as source 


code only, to any person who so requests it. 


The request must be made to the ‘registrar’ 
(me). The source code will be sent via CD 
ROM, thus the request must be accompanied 
by 3 IRCs, else it will be ignored. 

The SMSQ/E that will be so made available is 
the SMSQ/E as it stands NOW. Any future 
changes/additions/modifications/adaptions to 
this code may, or may not, be excluded from 


the offcial release version, since the authors 


of such 


changes/additions/modifications/ 


adaptions may state whether they want their 
source code to be included in the official 


Tony TEBBY 1987-2002. Any unauthorized 
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distribution, or not. 
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TF Services 


A UK 4-way trailing socket designed to switch off 
computer peripherals automatically when the com- 
puter is switched off, or (in the case of an ATX com- 
puter) when it auto-powers down. Compswitch has 
one control socket, and three switched sockets. 


A major hardware upgrade for the QL 
All Hermes features (working serl/2 at 19200, 
independent baud  rates/de-bounced keyboard/ 
keyclick) IBM AT kbd I/f // HIGH SPEED RS232 at 
57600// serial mouse port and 2 other RS232 inputs// 
3 V/O lines // EEPROM 
Cost (including manual/software)£90 (£92/£93) 
IBM AT UK layout Keyboard £11 (£13/£15) 
Serial mouse £8 (£8.50/£9) 
Capslock/scrollock LED £1 (£1.50/£1,50) 
Keyboard or mouse lead £3 (£3.50/£3.50) 
High speed serial (ser3) lead £4 (£4.50/£4.50) 


Hermes available for £25 (£26/£27) Working ser1/2 
and independent input, debounced keyboard. 


SuperHermes LITE: All Hermes features (see 
above) + an IBM AT keyboard interface only. 
Cost (incl keyboard lead) ................... £53 (£54/£55) 


Fixed price for unmodified QLs, excl microdrives. QLs 
tested with Thorn-EMI rig and ROM software. 


£27 incl 6 month guarantee 


Minerva 

“The ORIGINAL s ORIGINAI : ing system uperade 

OTHER FEATURES COMMON TO ALL VERSIONS 
DEBUGGED operating system/ autoboot on reset of 
power failure/ Multiple Basic/ faster scheduler- graphics 
(within 10% of lightning) - string handling/ WHEN 
ERROR/ 2nd screen/ TRACE/ non-English keyboard 
drivers/ “warm” fast reset. V1.97 with split OUTPUT 
baud rates (+ Hermes) & built in Multibasic. 

First upgrade free. Otherwise send £3 (+£5 for manual if requd). 

Send disk plus SAE or two IRCs 


MKL..£40 (£41/£43) MKIL..£65 (£66/£67) 


MINERVA RTC (MKID + battery for 256 bytes ram. 
CRASHPROOF clock & PC bus for interfacing. Can 
autoboot from battery backed ram. Quick start-up. 


Prices include postage and packing (Airmail where applicable). Prices are: UK (Europe /Rest of world). Payment by cheque drawn on bank with UK address,/ 
pestal order or CASH! [can no longer accept card payments as UK only does PDQ transaction. SAE or IRC for full list and details 


QL RomDisg ___ 
Up to 8 mbyte of flash memory for the QL 
A small plug in circuit for the QL’s ROM port (or 
Aurora) giving 2, 4 or 8 mbytes of permanent storage - 
it can be thought of as a portable hard disk on a card, 
and reads at some 2 mbytes per second. 
Think of it - you could fully boot an expanded QL, 
including all drivers/SMSQ etc off RomDisg at hard 
disk speed with only a memory expansion needed. 
2 mbytes RomDisq £39 (£40/£41) 
4mbytes RomDisq. £65(£66/£67) 
8 mbytes RomDisq £98 (£99/£100) 
Aurora adaptor £3 (£3. 50/£4) 


MPLANE 


A low profile powered backplane with ROM port 


A three expansion backplane with ROM port included for 
RomDisq etc. Aurora can be fitted in notebook case and 
powered off single 5V rail - contact QBranch for details. 


Two boards (eg Aurora and Gold Card/Super Gold Card/ 


Goldfire fixed to base. Suitable for Aurora (ROM accessible 
from outside) & QL motherboard in tower case. 


case. 


CO rst eae Beis Sevscisie et essere £34 (£35/£36) 


_____12C INTERFACES __ 


Connects to Minerva MKII and any Philips PC bus 


Power Driver Interface 16 Vo lines with 12 of these used to 
control 8 current carrying outputs (source and sink capable) 


2 amp (for 8 relays, small motors) £40 (£43/£44) 
4 amp total (for motors etc) £45 (£48/£50) 
Relays (8 3a 12v 2-way mains relays (needs 2a power 

£25 (£28/£29) 
Parallel Interface Gives 16 input/output lines. Can be 
used wherever logic signals are required £25 (£27/£28) 
Analogue Interface Gives eight 8 bit analogue to 
digital inputs (ADC) and two 8 bit digital to analogue 
outputs (DAC). Used for temp measurements, sound 
sampling (to 5 KHz), x/y plotting £30 (£3 1/£32) 
Temp probe (-40°C to +125°C) £10 (£10.50/£11) 
Connector for four temp probes £10 (£10.50/£11) 
Data sheets £2 (£2.50/£3) 


Specify 
ROM facing IN towards boards, or OUT towards back of 


£2 (£2.50/£3) 
OL SPARES 


Keyboard membrane .......0...0.00.60. 


..-.. nO longer on sale 
£3 (£3.50/£4) 
£3 (£3.50/£4) 
£8 (£8.50/£9) 

£10 (£10.50/£11) 
£12 (£17/£21) 


Circuit diagrams 
68008 cpu or 8049 IPC 


29 Longfield Road, TRING, Herts, HEP23 4DG 


Tel: 01442-828254 
tonya firshman.demon.co.uk 
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Fax/BBS: 01442-828255 


http://www. firshman.demon.ce.uk 
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No distribution of SMSQ/E may be SOLD, ex- 
cept for the official distribution. This interdic- 
tion includes that of including and distributing 
SMSQ/E in Public domain libraries. 

Official distributions will be sold in compiled 
(binary) form, possibly together with the 
official distribution as source code. For such 
sales, for the time being, two distributors/re- 
sellers, namely Jochen MERZ (UMS) and Roy 
WOOD (QBRANCH) have been appointed by 
the copyright holder Resellers provide sup- 
port for the versions sold by them. Binary, ie. 
compiled, versions of SMSQ/E may not be 
distributed other than through the distributors. 


The registrar, Le. me, will maintain official distri- 
butions of SMSQ/E, in binary and source code 
form, one for each machine on which 
SMSQ/E may run. 


Any person may make any changes/addi- 
tions/modifications/adaptions to the source 
code he feels like. Any person may give away 
to others the modification he thus made, 
including the official distribution in source 
code form only, provided this is made 
ENTIRELY FOR FREE - no charges, not even 
copying charges, or charges for the media on 
which this is distributed, may be levied. 

This distribution of the source code including 
the — changes/additions/modifications/adap- 
tions made by any author may not be made in 
electronic form other than on a physical disk. 
Distribution of the changes/additions may be 
in binary (compiled) form, provided that the 
original and/or official version of SMSQ/E, 
which is copyright - Tlebby, is not distributed 
in binary form as well. 


Any — changes/additions/modifications/adap- 
tions may be proposed by their author(s) to 
the registrar for inclusion in the official distribu- 
tions of SMSQ/E. The registrar is not obliged 
to inclue any proposed changes/additions/ 
modifications/adaptions in official versions. 
When making such a proposal for inclusion, 
the author of the changes/additions/modifica- 
tions/adaptions may state whether his con- 
tribution: 

- is to be distributed in the same way as the 
official version, or 

- is to be made only in the compiled (binary) 
form of the official distribution, or 

- is to be made alongside, but not included in, 
the official distribution. 
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Failing such a statement, the inclusion will be 
contained in the compiled and the source 
code versions. 

By submitting code to the registrar, the author 
agrees to the limitations as set out herein. 


Authors retain copyright over their changes/ 
additions/modifications/adaptions, but when 
and by submitting them to the registrar, they 
explicitly agree that, if they are accepted in 
any official distrioution {under the provisions 
hereof), they may be included in all other 
future distributions (in other words, you can't 
submit something, which Is included, and then 
some months later attempt to withdraw it). 
By and when submitting proposed changes/ 
additions/modifications/adaptions to the regis- 
trar, author(s) of such changes/additions/modi- 
fications/adaptions also agree that others may, 
in the future, bring about changes/additions/ 
modifications/adaptions to the code of any 
changes/additions/modifications/adaptions 
such as submitted to the registrar 
Copyright of the author(s} of any changes/ 
additions/modifications/adaptions will be ack- 
nowledged in the official distribution. 


For testing purposes only, authors having 
made one or several changes/additions/modi- 
fications/adaptions of SMSQ/E may, as an 
exception to the prohibition of distributing 
code stemming from the official release ver- 
sion in binary form as mentioned above, give 
away binary version of their code, together 
with binary versions of SMSQ/E, to not more 
than 10 persons in total (whatever the number 
of test versions}, provided that the persons 
receiving these test versions agree to destroy 
them: 

- after a period of 2 months, or 

- at the time the changes/additions/modifica- 
tions/adaptions for the test version are inclu- 
ded in the official release version, or 

- when they are notified by the author that a 
stable version is now available 

whatever comes first. 


A styleguide will be maintained by the regis- 
trar to which any addition must adhere. The 
styleguide will be part of the official distribu- 
tion. 


End of official statement. 
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| have already been approached privately by 

persons finding this licence unfair for two 

reasons which, at the time of writing, hadn't been 
aired in the Ql-users list (or anywhere else, to my 
knowledge) yet: 

1) When anew author adds some code to make 
SMSQ/E better only the resellers {and Tony 
Tebby) see some profit from it. 

2) Authors making additions etc are still prohibi- 
ted from distributing binary versions of 
SMSQ/E, even for free. 

This, some argued, will stifle the development of 

SMSQ/E since no author will agree to that. 

| personally do not think that these arguments are 

really a hindrance to the future of SMSQ/E - the 


resellers provide support when selling the binary 
versions, hence they should get some money, 
and some restriction in the binary distribution is 
acceptable for that. We also want to avoid 
having too many unofficial versions floating 
around. 

lf you have any strong feelings in this respect, 
please let me know! 


| have now received the source code from Tony 
Tebby, and, as soon as this licence is hammered 
out and | have had a chance to put everything in 
order, I'll start sending it out. 'm now taking 
orders... 


Wolfgang 


Clocking In - Part 3 


David Denham 


In this part of the series we are 
going to have a look at a date 
calculation formula called Zel- 
ler's Congruence. 

Using this mathematical formu- 
la enables us to calculate 
which day of the week corres- 
ponds to a given date - in 
other words, we can write a 
program to tell us on which day 
of the week we were born, 
what day of the week next 
year's Christmas day will fall on 
and so on. 

Since the present calendar 
only came into being in 1582 
(adopted for use in Britain and 
America in 1752) and will 
accumulate an error of one day 
by the year 4902, the calendar 
is only valid for use from 1582 
to 4902. This is hardly likely to 
be a problem! 

One unusual aspect of the Zel- 
ler's congruence formula is that 
although we would think of Ja- 
nuary to December as month 
numbers 1 to 12 respectively, in 
fact the formula treats March 
as month number 1, December 
as month number 10, January 
as month number 11 and Febru- 
ary as month number i2. Thus 
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{st January is in fact the begin- 
ning of the eleventh month of 
the previous year Not a pro- 
blem as long as we are aware 
of this. 

We need the following informa- 
tion for the formula: 


day: day number of the month 
(1 to 28, 29, 30 or 31) 

month: (Jan=11,Feb=12 March=1 
etc as described above) 

year: the last two digits of the 
year number (0-99) 

cent: century number (ist two 
digits of year number) 


This formula returns a number 
(dn) from 0 to 6, which corres- 
ponds to Sunday (0) to Satur- 
day (6) respectively. 

dn=( ((2.6%month)-0.2) + 
day + year + (year/4) + 
(ceent/4) -— (2¥cent) ) MOD 7 


In practice, the routine can 
return a negative number so 
you will see some programs 
(including examples below) 
which add a large positive num- 
ber divisible by 7 before carry- 
ing out the "MOD 7’ calculation 


just to ensure that the number 
is already positive (adding a 
number divisible by 7 should 
make no difference to the MOD 
7 action). 


The simplest application of Zel- 
ler's Congruence Is a little pro- 
gram in Listing 1 which asks 
you to enter a date then tells 
you what day of the week that 
date falls on. For example, try 
entering 25th December 2002 
to see what day Christmas day 
falls on this year Incidentally, 
when entering month numbers, 
just enter 1 for January, 2 for 
February, 3 for March and so 
on. The program takes care of 
adjusting to the other number- 
ing system described above. In 
addition to telling you the day 
name, it also tells you if the 
year in question is a leap year 
or not, since it needs to work 
this out as part of the other 
calculations. 

You may find it useful to add a 
few lines to this program to 
error trap the entries - make 
sure that the numbers entered 
are positive whole numbers, 
that no invalid numbers of days 
are entered (eg. February 
cannot have more than 29 
days) and that the year 
numbers entered are in the 
range 1582 to 4902. 
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Listing 1 - Day Of The Week 


100 REMark day of the week, using Zeller's Congruence 
i110 : 

120 INPUT'Day (0-31) >» '3dayl 

130 INPUT'Month (1-12) > 'ymonth 


140 


REMark month number should be Jan=11,Feb=12,Mar=1,Dec=10 


150 REMark adjust the month number accordingly 


160 IF month<3 THEN adj_month=10+month:ELSE adj_month=month-2 
'syear 


170 INPUT'Year (1582-4902) > 
180 :: 


190 REMark decide if a leap year 


200 IF (({year MOD 4)=0 AND NOT((year MOD 100)=0)) OR (year MOD 400) 
REMark leap year = yes 


is a leap year': 
210 adj_year = year 


220 REMark Jan and Feb are months 11 and 12 of previous year 


230 IF adj_month » 10 THEN adj_year=adj_year-1 


240 century = adj_year DIV 100 : 
= adj_year MOD 100 : 


250 year_in_cent 
260 : 


270 REMark this is Zeller's Congruence 
280 day_no=(INT(2.6*adj_month—.2)+dayi+year_in_cent+(year_in_cent DIV 4)+(century DIV 


4)-2*century+700) MOD 7 


290 PRINT day1;'/';month;'/';year;' 


300 SELect ON day_no 


310 =0 : PRINT 'Sunday' 
320 =1: PRINT 'Monday' 
330 =2 : PRINT 'Tuesday' 
340 =3 : PRINT 'Wednesday' 
350 =4 : PRINT 'Thursday' 
360 =5 : PRINT 'Friday' 
370 =6 : PRINT 'Saturday' 


380 END SELect 


The next useful step is to pro- 
duce a program which calcu- 
lates dates to the extent that it 
can print calendars for us. | 
wrote such a program, but | 
could not get it to work reliably 
at the turn of the century, so 
the editor sent me a similar 
program he'd written which 


Listing 2 - Calendar 


100 REMark QL Calendar program, uses Zeller's Congruence 


110 : 
120 WINDOW 448,200, 32,16 : 
130: 


(DD/MM/YY) is a '; 


does seem to work as inten- 
ded, which | present here in 
Listing 2 slightly shortened. 

As it stands, the program just 
prints the calendar to the 
screen. Change the 

PRINT Statements to 


PRINT #channel_no, where 


CLS 


140 DIM month$(12,10),days_in_month%(12) 


150 RESTORE 

160 FOR a=1TO 12: 
170 aus a=1T012: 
180 

190 REPeat get_year 


READ month$(a) 
READ days_in_month%(a) 


200 INPUT'Enter year (e.g. 2002):';year% 
210 IF year% >= 1752 AND year% «=4902 THEN EXIT get_year 


220 END REPeat get_year 
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= Q THEN PRINT year;' 


REMark the century number 15 to 49 
REMark year within century 00 to 99 


channel_no Is the number of a 
channel opened to the printer, 
e.g. OPEN#3,SERI to make pa- 
per printouts. If you want to 
pause the output between 
months, simply add a PAUSE 
Statement with 585 PAUSE, 
then you'll need to press a key 
to print the next month. 
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230 


240 : 


250 


CLS 


REMark find day of week of January ist 


260 LET century = (year%-1) DIV 100 : REMark century 

270 LET yearl = (year%-1) MOD 100 : REMark last 2 digits of year 

280 day_no = 799+yearl+(yearl DIV 4)+(century DIV 4)-(2*century) 

290 day_no = -(day_no MOD 7) 

300 : 

310 leap_year = 0: REMark is this a leap year? 

320 IF ((year% MOD 4)=0 AND NOT((year% MOD 100)=0)) OR (year% MOD 400)=0 THEN 
leap_year = 1 

330 : 

340 FOR month_no = 1 TO 12 

350 PRINT \\ TO 11;month$(month_no);' ';year% 

360 PRINT \ TO 4;'SUN MON TUE WED THU FRI SAT! 

370 IF month_no = 2 THEN 

380 REMark February has 29 days in leap years 

390 days_in_month%(month_no) = days_in_month%(month_no)+leap_year 

400 END IF 

410 FOR line_no = 1 TO 6 

420 FOR column_no = 1 TO 7 

430 day_no = day_no + 1 

440 IF day_no >» days_in_month%(month_no) THEN 

450 start_next = column_no : EXIT line_no : REMark end of month 

460 END IF 

470 IF day_no » O THEN 

480 PRINT TO column_no*4; 

490 IF day_no <« 10 THEN PRINT ' '; 

500 PRINT day_no; 

510 END IF 

520 END FOR column_no 

530 start_next = 1: REMark previous ended on Saturday 

540 PRINT : REMark go to start of next line 

550 IF day_no = days_in_month%(month_no) THEN EXIT line_no 

560 END FOR line_no 

570 day_no = 1 — start_next : REMark where does next month start 

580 PRINT 

590 END FOR month_no 

600 : 

610 REMark data for names of months, and days per month 

620 DATA 'JANUARY', 'FEBRUARY', 'MARCH', 'APRIL', 'MAY', 'JUNE! 

630 DATA 'JULY', 'AUGUST', 'SEPTEMBER', 'OCTOBER', 'NOVEMBER', 'DECEMBER! 

640 DATA 31,28, 31, 30,31, 30, 31, 31, 30,31, 30,31 


lf you want to adapt the 
program to only print certain 
months of the year, you'll need 
to ask the user to enter the 
number of the month to print 
from, and the number of the 
month to print to. Within the 
FOR month_no loop, all PRINT 
statements will need to be 
modified with an IF clause like: 
IF month_no >= 
print_from_month AND 
month_no «= 
print_from_month THEN 
PRINT... 
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The printout is a fairly basic 
monthly format calendar as 
shown in figure 1. Have fun 
changing it to different formats! 


Figure 1 - sample output from 
calendar program 


MAY 2002 


SUN MON TUE WED THU FRI SAT 
1 23 4 
5 6 7 8 9 10 il 
12 13 14 15 16 17 18 
19 20 21 22 23 24 25 
26 27 28 29 30 31 


JUNE 2002 


SUN MON TUE WED THU FRI SAT 

i 
23 4 5 6 7 8 
9 10 12 12 13 14 15 
16 17 18 19 20 21 22 
23 24 25 26 27 28 29 
30 


Finally, Listing 3 is a short pro- 
gram to help calculate the date 
of Easter Sunday for a given 
year This one does not use 
Zellers congruence and is in- 
cluded as a good example of 
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Text 87 PROGRAMMING 


QD 98 £ 45.00 


£79.00 QD + QBasic £59.00 
Typset 94 £29.00 QD + Qliberator + QBasic £ 100.00 


Fountext 94 £ 39.00 Qliberator £50.00 
2488 drivers £29.00}] Master Spy v 3.3 £ 30.00 


Epson ESC/P2 drivers QPTR £ 30.00 
£26.00 Easyptr pt 1 & 2 (together) £ 30.00 


Text 87 is the only QDOS Easyptr pt 3 (C library) £ 14.00 

/ SMSQ wordprocessor QMake £ 15.00 
capable of handliing the QMon/JMon £ 22.00 
full screen on the Aurora Basic Linker £ 19.00 
/ QXL/ QPC systems. New DISA 3 £31.00 


drivers are cu igs 
Lanai QMenu £ 14.00 


Summer Fun Time 
Q Branch have a special summer offer for you while stocks 
last. Any of these games at only £ 5.50 each : 
Arcanoid, The Wall, Mine Field, QShang, Firebirds, Pipes, 
Doubleblock. 

Super Games Pack with four great games only £10.00 
Black Knight Chess Only £ 35.00 
Have a good time with your QL! 


Qubide IDE intefaces : £ 45.00 


BIG NEWS !! 
Price reductions for SMSQ/E and QPC 2 
See next page for details 


New Program 


Just Words' by Geoff Wicks 


THESAURUS, STYLE CHECK 
£ 10,00 ea / ANY 2 PROGRAMS £ 18.00 / ALL 3 PROGRAMS £ 25.00 


(Inctudes Pointer and non-pointer driven versions} 
( P.E. versions need Hot_rext, WMAN and PTR_GEN or SMSQ£E to run ) 
Upgrades from previous versions £ 2.50 + S.A.E. New Manuals £ 1.50 


QL2PC 


Convert text files from QL to PC formats uppott j 
and much more ! L* 


Only £10.00 now 
QL Rhymes ¢ 10.00 


Rhyming Dictionary 


Spelling Crib : PD program £ 1.50 +SAE 
or Free if you buy all three programs 


UTILITIES 


FiFi 2 £ 18.00 
QSup £ 28.00 
QSpread v 3 £ 48.00 
Cueshell 2 £15.00 
Qload/Qref £15.00 
Disk Mate 5 £ 16.50 
QPAC 1 £ 20.00 
QPAC 2 £ 40.00 
QTYP 2 £ 30.00 
QLQ £ 28.00 


We are currently out of stock of the SuperBasic Reference Manual 
Place your order now to get one as soon as it is reprinted 


The SBASIC / Sup erBASIC Reference Manual [ Over 500 


The complete definitive guide to asic programming in QDOS/SMSQ including | Pages ! 
three disks of PD toolkits, example procedures and an electronic index. £ 40.00 
compiled by Rich Mellor, Franz Hermann and Peter Jaeger : 


+ postage 


News on the SuperBasic Reference Manual Coming soon ! 
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‘Tel +44 (0) 1273-386030 fax +44 (0) 1273-430501 
Mobile +44 (0) 7836-745501 


nch@gbranch.demon.co.uk web : hitp:/Aww.gbranch.demon.co.uk 


New Fax Number 


Hardware 


We have a small stock of second user items. Auroras 
/ Qubides / Gold Cards / Qplanes / superHermes etc. 
call us to get details of the items available. These 
are going fast so call soon. 


QXL II £ 100.00 
Recycled superHermes £ 65.00 * 


Recycled Gold Card £ 45.00 * 


Dae ° 1) 
O Branc 
Feeling out on a limb ? 
Reach out for O Branch. 
Suppliers of Quality QDOS/SMS@Q products 
Hardware and Software. 


20 LOCKS HILL, PORTSLADE, 
E. SUSSEX. BN41 2LB. UK. 


ProWesS 


ProWess (now free !) £ 1.60 
DATAdesign £ 20.00 
Fontutils £ 28.00 


Recycled Aurora See over* 
File Search £11.00 . 

Qubide See over 
PFlist £11.00 Qplane £ 25.00 
Dilwyn's Fontpack £ Call Aurora cables £3.00 
LINEdesign v 2.16 £ 22.00 Aurorarom adaptor £3.00 
PWfile £17.50 ‘Arfa Braquet' £ 8.00 

‘Son of Braquet' £ 18.00 
Paragraph The ‘Braquet' £ 16.00 
The ProWesS word processor MC pl ate £ 6.50 


Demo version £ 1.50 + postage 
Full Registered version £ 18.00 


e now ! 


* when available. 


ersion 2.03 availabl 


Qubide upgrades to version 2.01 £ 8.00 


SMSQ/E Now Only £ 32.00 


Gold Card / Atari / QXL Version Various Atari versions : call for details 


QPC 2 v3 full colour version! joerades from apc 1 £46.00 eta 
Upgrades from QPC 2 v1 £ 30.00 Ster qj 
; Now Only Eo 6 ) ° OO Upgrades from QPC 2 v2 £ 14.00 7 
Special offer | If Bought/upgraded after 15/10/01 £ 5.00 


Get Cueshell for only £15.00 with any copy of SMSQ/E 
or QPC 2 upgrade ! 


Q Branch Programs 


The Knight Safe 3 £35.00 Q- Route v1.08C £25.00 


upgrades from previous versions £5.00 Route finding programme 
Q - Count £25.00 The Fractal Collection £ 35.00 


Pointer driven home accounting 


Post and Packing is included with Software Prices 


We can accept payment by Visa, Mastercard and Switch. We also accept 
cheques drawn on a UK Bank in Sterling. 
You can also pay directly into our bank in Euros. 
Barclays Bank Acc# 79016888 sort code :20-71-02 Name :QBranch) 
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how easy certain calculations 
are once you know the base 
formula. 

Easter Sunday occurs on the 
first Sunday following the first 
full moon which occurs on or 
after 2ist March. The actual 
formula for calculating the date 
on which Easter Sunday falls is 
taken from one of the classic 
programmers’ bibles, Donald 


Knuth's ‘Fundamental Algo- 
rithms’ published by Addison 
Wesley Publishing, [SBN 


0-201-03821-8, in case you'd 
like to try to obtain a copy! In 
fact, the algorithm is from the 
16th century from the work of 
Aloysius Lilius and Christopher 
Clavius. 

First we calculate the number 
of the year in the 19 year Meto- 
nic cycle (a period of 235 lunar 
months or about 19 years, at 


the end of which the phases of 
the moon recur in the same 
order and in the same days as 
in the preceding cycle) in line 
150. Then we calculate the 
century number - 1999 would 
be 20th century but 2002 is 
2ist century - who can 
remember or work out which 
century was 2000? 

Line 170 makes a little correc- 
tion to allow for the fact that at 
the turn of each century, only 
one in four is aleap year (1700, 
1800 and 1900 were not, 2000 
was a leap year). Line 180 is 
designed to synchronise Eas- 
ter with the moon's orbit. Line 
190 locates the sunday. 

Line 200 to 230 are concerned 
with the epact, the excess of 
time of about 11 days of the 
solar year compared to the 
calendar year. 


Listing 3 - Easter Sunday calculator 


100 REMark calculate Easter day date 
110 REMark from Knuth's "Fundamental Algorithms" 


120 : 
130 CLS 


140 INPUT'Year for which Easter is required ';year 
150 golden = (year MOD 19) + 1 

160 century = INT(year/100)+1 

170 leap_correction = INT(3*century/4) - 12 

180 moon_orbit = INT((8*century+5)/25) - 5 

190 sunday = INT(5*year/4) - leap_correction — 10 


200 epact = 11*golden + 20 + moon_orbit - leap_correction 
210 IF epact « 0 THEN epact 


220 epact = epact MOD 30 


epact + 30 


Next we set about finding the 
full moon (remember that the 
Easter Sunday is the Sunday 
following the first full moon on 
or after the 2ist March. Line 
260 winds us on to the Sunday 
itself, but since the value of 
find_full.moon will roll on into 
April if Easter Sunday rolls past 
the end of March, we need to 
subtract 3ist March from this 
value if in April - the routine 
might try to tell us that 15th 
April was in fact 46th March 
otherwise! 

lf you'd like to generate a list of 
Easter Sunday dates rather 
than calculating each individual- 
ly, add a FOR loop which gives 
a range of values for the varia- 
ble ‘year’ instead of the INPUT 
statement shown, e.g. 


FOR y=2000 to 2099 and 
LET year = y 


230 IF (epact = 24) OR ((epact = 25) AND (golden » 11)) THEN epact = epact + 1 
240 find_full_moon = 44 - epact 
250 IF (find_full_moon « 21) THEN find_full_moon = find_full_moon + 30 

260 find_full_moon = find_full_moon + 7 — ((sunday+find_full_moon)MOD 7) 


270 CIS : 


PRINT'Easter day is '; 


280 IF find_full_moon «= 31 THEN 
290 PRINT'March ';find_full_moon 


300 ELSE 


310 =PRINT'April ';find_full_moon - 31 


320 END IF 


That brings this series to a 
close unless someone has 
more material or any correc- 
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tions or improvements to con- 
tribute. | hope you have found it 
useful, | have enjoyed writing it 


and all that | have learned while 
preparing it. 
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A short visit of XMenu - 
Part 1 


Jérome Grimbert 


The Xmenu library comes with a config block 
which allows the end user customise the 
appearance of the PE items managed by the 
Xmenu_ library The customised colour is 
accessed by calling the DefaultColourSet() func- 
tion. If a programmer does not want to use the 
config block or want to have their handling, he 
only has to provide a pointer to a colourSet 
Structure (this structure is defined in xmenudefh 
file), and of course to fill it as he wants. All the dis- 
playing functions take this pointer as first para- 
meter, and are able to work in mode 8 too (if the 
primary is big enough to accomodate the bigger 
text, otherwise the functions just return simulating 
an ESC [for the function which gives back a 
value). 


Message Report 
Iten_select__ Message_Report() is very 
simple: the additional para- 
meter is just a string to be 
displayed until Enter/Do is 
performed on “the popup (ESC also works). 
Message_Report opens a secondary window, so 
the primary must already exist. 
For the case when there is no_ primary, 
Startup_Report() is the one to call instead of 
Message _Report(). 
One interesting feature of Xmenu is that the 
string can contain chr$(10) (LF) to indicate a multi- 
line message. 


Message Report O 
Display a single message 


DO to exit this window 


String Edit 


oo String edito 2 
This. function allows the user to 
edit a string 


String _Edit() 
allows to edit a 
string. The addi- 
tional parameters 


with a default value and a max length! 
‘Your string here 


are: 

- a title for the window 

- an explanation text, which can be multi-lines 
- a default value 

- a max length for the string 

- the current value 


Upon exit, an integer is returned which is the 
length of the actual string, unless ESC was used 
in which case ~1 Is returned. 
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XDialog{) was in- 

spired by the Xii 

dialog where 

there is usually 

an icon on the 

left of some text 

and some classical choice is offered. For our 

favorite system, the icon has been replaced by a 

sprite. The additional parameters are: 

- a title for the window 

- a message 

- a sprite 

- a boolean (0/!0) to choose between ok/cancel 
or ok/cancel/help as items 


G40 -FC or ok-help/cancel: button 
Ok Help Cancel 


Upon exit, an integer is returned: 
-1 if ESC was used to exit 

0 if Ok was chosen 

1 if Cancel was chosen 

2 if Help was chosen 


Button 


Any Text con go |! J Because putting an application to 


. sleep as a button is always the 
@ same, but can be different when there 
ens Bis or is not a button frame, Menu_But- 
B ton_Text() and Menu_Button_Logo() 
are here to avoid reinventing the 
wheel each time. The additional parameters are: 
- the main window definition (the one to hide until 
the button is removed and the application is 
restored) 
- either a text or a sprite for the button (accord- 
ing to the called function) 


lf there is a button frame, the button will get 
inserted into it, otherwise the ‘classical’ floating 
button will be available. 


Item Select 


Item SelectO | 
This function allous 
to choose one among many 


Item, Select_Array@ ae 
This function also atlays 
te choose one among many 


example with 5 
First. Third Fifth 
Second Fourth 


And you pass .ancarray of char x 


rather than a 
variable number of parameters. | 


First Third. Fifth 
Second Fourth 


ltem_Select(} and 

ltem_Select_Array(} allow the choice of option 
among many. The additional parameters are: 

- a title for the window 

- an explanation message which can be multi-line 
- the number of options 
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Then Item_Select() has a string for each possible 
option (using a variable number of arguments!) 
whereas Item_Select_Array(} has a single pointer 
to an array of string (also one for each option). 


As usual, if ESC is used to exit, -1 is returned, 
otherwise the number of the choosen option is 
returned (0 being for the first option). 


The programmer does not have to worry about 
the size of the window and has no control on the 
relative positions of all items: all is done by the 
Xmenu library (it make things simpler for quick 
code, but takes away some freedom of design 
with the burden). 


List. Select 


z “List selecto— ] List_Select() and 
This func on aoe to choose, List_Select_Array() 

allow to select many 
among many op- 
tions. There is one 
additional parameter 
from ltem_Select: a 
Status list which indi- 
cates the initial {and 
after the function 
call, the final) status 
of each option. The 
PE values are direct- 
ly used in this list. The returned value is the 
number of selected items. 


It.is even possible to have some 
unavailable items | 
First 
Second 
Third 


Fourth 


: “List wSalect.RrrayO Sane 
This function also alloys 
to choose many among many 


And you pass on carray of chor * 
rather than a 
varieble number of. parameters! 
Fourth 
Fifth 

ee 


First 
Second 
Third 


Radio Select 


ee 

“Radio_SelectO 5 | 
This “function allows ta choose 
one among: many 


Radio_Select() | and 
Radio_Select_Array() 
allow to choose one 
among many options, 
but with a radio-but- 
ton behavior There is 
one additional para- 
meter from the 
ltem_Select: the initial 
item which is selec- 
ted. The returned va- 
lue can be -1 in case 
of ESC, or the number of the radio button which 
ends up as being selected. 


But ‘you're allowed to hesitate 
until OO. ! 


(First) Third Fifth 
Second. Fourth 


fo Radio Select Array 
This function also allovs 
to choose. one amang many 


And you pass an array of char. * 


rather. than a 
variable. number of parameters | 


oPipst > Third. Fifth 
Second Fourth 


Radio_Select_Range() saves the programmer 
from writing a full list of incrementing values, 
instead only the minimal and maximal values are 
provided with the step to use between the value. 
lt works only with integer values. 
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— “Radio_Range_SelectO- 99 = 9 = 
ction ating to choose an integer inside a given range 


And the. step between the number is not. limited to i ! 


It would be long to type all this by hand ! 

S12 4608 s7ad 12900 16896 20992 25098 29184 33280 
1024-5126 9216 13312 17488 21584 25606 29696 33792 
1536 5632 9728 19824 17928 22816 26112 30288 34304 
2848. 6144 19246 143236 18432 22528 26624. 30726 34816 
2568 6656 18752 14849 18944 23648 27136 31232..35326 
3672. 7168. 11264 15366 19456 23552 27648 31744 35848 
3584 7686 11776 15872 19968 24064 28168 32256 36352 
4996 8192 12288 16384 20486 24576 28672 32768 36864 


Non displayable functions 


Adapting window definition 


- LimitGeometry() allows limiting of the maximal 
size of a primary, thus allowing a programmer to 
make an universal huge setting in the default 
value of the definition and adjusting to the actual 
size of the display (thus allowing 1280x960 win- 
dows on QPC and restricting to 1024x512 on 
Q40, while stopping at 512x256 on normal QL). 
Best used with DisplayXSize(} and Display 
YSize(). 

- SetinfoColour() applies the choices of colour 
from a colour_set over an information ‘window’ 
definition {it's a sub-part of a window), allowing 
the user to really customise the colour in the 
application. SetWindowColour() performs the 
same for the (primary) window definition. 


Adapting sprites 


SmartHighColour() is a function which adapts a 
high-colour (16 bits) sprite to either the Q40 mode 
or the QPC mode. Because high-colour sprites 
are heavy for memory, one might not want to 
double the memory consumption to have both the 
Q40 and QPC version of the same sprite. So this 
function just performs the adaption of one mode 
to the other when portability low memory and 
high-colour are wanted at the same time. 


Getting screen information 


- DisplayXSize(} and DisplayYSize() returns the 
actual size of the screen, until a primary is 
drawn. 

- Get_NativeForm() return the form that a sprite 
must use to be considerated as Native (works 
for mode 4, mode 8, Q40 and QPC; Aurora is 
unknown due to lack of information). 

Get_CharSize() gives the length in pixels of 
each character, if you ever need to know it. (6 
unless in mode 8 where it is 12 !). 

- Check_Size{) tells you without crashing if a 
window can be drawn or not. 
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CAMBRIDGE 


OFFICE/FAX 01494-871319 (EEC) WAN. Richardson & Co. 


. 6 Ra d 
MOBILE: 07808 576118 _ Chalfont StPeter 


E-MAIL: WNR@COMPUSERVE.COM Buckinghamshire SL9 ONB 


THE IDEAL PORTABLE COMPANION FOR THE QL, PC AND MAC. 


THE CAMBRIDGE 288 A4 NOTEBOOK 


WITH BUILT-IN WORD PROCESSOR, SPREADSHEET, 4 
DATABASE, BASIC, CALCULATOR, CLOCK, ALARM, YX 
CALENDAR & VT52 TERMINAL. - 
USES 4XAA ALKALINE CELLS (ca. 20 HOURS) * CE 
yen 


WE DQ REPAIRS, PART EXCHANGES, AND BUY Z88's & PARTS © 


NEW! CAMBRIDGE Z88 WITH 024+512k Internal Ram £150 
ALSO AVAILABLE, 512k RAMPACK £40 


DESCRIPTION : 


32k RAMPACK 
128k RAMPACK 


128k EPROM PACK 
256k EPROM PACK 
EPROM ERASER 


PARALLEL PRINTER LEAD 

SERIAL PRINTER LEAD 

%* MAINS ADAPTOR (230vac: 6v,500ma) 
TOPPER (PROTECTIVE COVER) 

CARRYING CASE (PLASTIC) 


PCLINK KIT (For PCs) 
Z88 TO MAC KIT 
288 TO BBC KIT 


POSTAGE UK UP TO £5. EEC £15. USA £20. OTHER COUNTRIES £30. 


ALL THE STOCK IS WARRANTIED FOR 90 DAYS. IN THE EVENT OF REPLACEMENT 
BEING ARGREED, BUT THE ITEM BEING OUT OF STOCK AT THE TIME, A REFUND 
WILL BE MADE PROVIDED THE ITEM IS RECEIVED IN GOOD CONDITION. 


OL & PC COMPUTER USERS WILL FIND THE CAMBRIDGE 288 ESPECIALLY USEFUL FOR WORK AWAY FROM 
THE DESKTOP, WITH TRANSFER PROGS DATA CAN BE SAFELY EXCHANGED WITH THEIR DESKTOP SYSTEM. 


W.N.RICHARDSON & CO CONTINUES TO PROVIDE FULL SPARES AND 
SERVICES FOR SINCLAIR COMPUTERS, OL & THE CAMBRIDGE 288 
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Getting sprite information 


Get_Graphincinfo extracts the size and origin 
information from a sprite, taking into account the 
actual mode of the display and the various 
modes in the linked chain of a sprite (because 
the first sprite definition might not be the one that 
will be used by the system!). 


Logo 


The Xmenu Library comes with a sprite (64x60), 
it's just xmenu_logo. You can see it on the 
XDialog picture. 


Why this visit? 


Now that you know what's provided by the 
Xmenu library, it might be easier to perform some 
mundane tasks and concentrate on the important 
part: your application! So let's go back to the 
explanation of PE in C in the next issue. 


Simon N Goodwin writes: 

The article ‘Which machine am | running on’ last 
issue was a bit frustrating as it makes several 
assumptions that clash with Qdos Classic and 


Amiga Qdos conventions that have been 
established and freely available for years. The 
variable at offset 161 in Mark's systems (QDOS 
Classic etc -DJ) matches the document, but the 
one at 167 does not, and this Is the first time I've 
even seen it mentioned. Contrary to the article, it 
doesn't work on my Gold Card ~- maybe it is 
SMS only? 

it also seems a pity that the article didn't mention 
or take account of QLAY or the various Thors, 
QEm or UQLX, etc. While | understand that Marcel 
may not be interested in those, they ought not to 
be excluded from QL Today and so | think it was 
a mistake not to mention or allow for them. 
Rather than present that information as if it was 
complete, I'd prefer to see suggestions about 
how it can be extended without running the risk 
of people using the same code for more than 
one system. 
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PROCESSOR_ASM (in the free Qdos Classic 
sources) can work out the value for 161 in a 
general way for all 68Ks. | can see no general 
way to add or abstract the information attributed 
to byte 167, but there are ad-hoc ways that work 
on most emulators and add-ons so the list could 
be extended to include the whole Qdos commu- 
nity, not just the SMS subset. It is not sensible for 
QL Today to close out any potential readers: the 
article should at least have mentioned the ob- 
vious gaps. 


Reply from the Editor: 

In volume 6 issue 5 an article from Marcel Kilgus 
and | described the use of facilities in SMSQ/E 
based systems which tell you what kind of pro- 
cessor, display and so on is available on which 
type of machine. Simon Goodwin, John Perry and 
others pointed out that this article contained no 
information relevant to QDOS users leg. Amiga 
QDOS users). 

As far as | was aware, there was no support in 
any version of QDOS for these facilities and as | 
did not know how SMSQ/E obtained this infor- 
mation from the hardware on the machine it was 
running on, | did not even know if these facilities 
could be implemented in QDOS. 

| circulated an email to the authors of the various 
QL emulators and Minerva asking if their pro- 
ducts had any support for anything like this or if 
they might at some point in the future do so.! got 
just one reply - asking for a copy of the article 
as he hadn't seen it. So do | take it that the 
answer is a firm NO? 

So | am now going to issue a public appeal. 
Jochen does not have enough knowledge of 
QDOS on other systems (he’s been an SMSQ/E 
man for years of course) and | don't really have 
enough knowledge of either at this level (which is 
why | got Marcel to co-operate on the original 
article) - does anyone reading this have the 
necessary knowledge to help us with this one? Is 
there any software package already out there 
which will provide some or all of these facilities? 
Simon is correct to point out we should not ex- 
clude QDOS users totally. I'm told the Gold Card 
and SuperGold Card patch QDOS to some 
extent to provide processor information at least, 
so it is probably possible in QDOS with the right 
knowledge. And with the SMSQ/E development 
becoming a bit more open, with access to the 
source codes now possible as the SMSQ/E 
Registrar (Wolfgang Lenerz) has described, 
someone with knowledge of the operating 
system at this level may yet be able to bring 
such facilities to ‘vanilla’ QDOS. Please. 
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Last Minute News 


PQIV QXL and QPC support 

QL Today reported in the first News Section 
about a new version of PQIV from Claus Graf. 
Unfortunately, it stil does not support QXL and 
QPC screen modes. 


Marcel Kilgus has find an easy way to patch the 
new version of PQIV so that all QLers with 
hi-colour graphics mode can benefit from the 
program. 


The patch can be downloaded from the public 
archive: 


http://www.mail-archive.com/ql-users%40nvg.ntnu.no/ 
msg05967.html 


QPC? News 


The next sub-version of QPC2 Version 3 wil 
hopefully be released by the time you read this 
News (i.e. first chance at the North American QL 
Show). Marcel is working hard to get it ready for 
the show. 

The new version QPC2 V3.03 will most likely 
contain the new Window Manager (features 
described in the previous issue of QL Today) and 
improved control commands for the DOS device 
(e.g. DOS_DRIVE$). Marcel also hopes to have a 
new memory scheme implemented which works 
like the one implemented on the ATARI TT This 
will speed up file access time considerable with 
large amounts of RAM! 


Updates from previous version 3 will be free, 
for other upgrade prices check the JMS advert. 


W POTS OFFEWTS AND SNIPPETS __ 


The factory which makes the 
dots for ‘I's and the crosses for 
'ts has been going into pro- 
duction overdrive over the last 
two months as Wolfgang Le- 
nerz struggles heroically with 
the SMSQ/E licence agree- 
ment. One thing which has 
come out of the whole affair is 
how much people can fail to 
agree, even when the argument 
is largely to everyone's benefit. 
Somehow or other people 
seem to want to say ‘Oh you 
are going to let us have it a lot 
cheaper - well that is not good 
enough give it to me for no- 
thing’. 

| have made a lot of comments 
in the past about free software 
and | suppose that you all know 
these very well by now but it 
seems obvious to me that you 
can have SMSQ/E for free if 
that is what you want but there 
will not be anyone around to 
support it or provide you with a 
manual (which some of you will 
not read anyway) or help you 
when you have a_ problem 
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which you cannot either under- 
stand or get around. Many of 
the people who are clamouring 
for it to be a free system are 
those for whom reading a 
mass of source code and un- 
derstanding it would be a sim- 
ple task but these are not the 
average user. | have often re- 
marked that the ‘here are the 
extensions/code - write your 
own front end’ brigade react 
contemptuously when faced by 
users who cannot do that. | 
equally cannot see why some 
people shun writing some sim- 
ple programs to perform useful 
tasks because ‘the user could 
write that themselves in BASIC’. 
Given that | am one of those 
who advertise their phone and 
internet details in the QL press | 
have a lot of contact with the 
end user and | can tell you that 
many of these are just that - 
users. They use a QL or a QL 
emulator because they know it 
and they have no real need to 
have to learn another system. 
They cannot write anything and 


even a BOOT file is regarded 
as ‘beyond my abilities’. This is 
not criticism or one-upmanship, 
just pure observation. In many 
cases, if they sat down and 
tried they would get the hang 
of it very quickly and | do not 
think that any of them are 
stupid in the least. 

People like Jochen, Tony Firsh- 
man and | are here to provide 
support for the users and we 
do try to do this with as much 
patience and goodwill as possi 
ble. | have been known to get 
upset when people ask the 
same question over and over - 
especially when the answer |s 
in the manual and they have not 
bothered to read it - but it is 
rare. This support work is com- 
pletely unpaid and, to return to 
the SMSQ/E question, the small 
fee that is left over after we 
have paid Tony Tebby, printed 
the manuals and provided the 
disk goes a little way towards 
paying us for all the work. 


It is Not a Horse It Is 


Just Two Coconuts. 

The whole argument between 
some of the people who want 
a completely free SMSQ/E and 
the ‘gang of five’. as Wolfgang 
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Lenerz calls the five people 
who were present at the Eind- 
hoven meeting which thrashed 
out the start of the licence for 
SMSQ/E has begun to turn into 
one of those Monty Python 
style arguments. People seem 
to find ever more esoteric 
examples and exceptions and | 
begin to wonder if they are 
arguing in their spare time. 
Some people argue about one 
thing and some about another. 
It has even got to the stage 
where some people are ar- 
guing about the arguments 
other people have put forward. 
Maybe two swallows got toge- 
ther and carried all these argu- 
ments here because one swal- 
low could not have managed it 


| Liked The System so 
Much | Bought The 
Copyright! 


One person wanted to pay 
Tony Tebby 300 Euros to be 
allowed to give it away for free. 
Well that is very altruistic but as 
soon as he has given away 
more than 30 copies Tony is 
also making a loss. Some of 
this is tied up in the particular 
kind of politics that has 
emerged in the QL World over 
the last year or so with one 
Side trying to rubbish the other 
Conventional capitalist wisdom 
is that competition is always a 
good thing for the consumer 
and, ipso facto, this kind of 
competitiveness should make 
the two sides strive to improve 
their systems. 

Well, sometimes it is and some- 
times it isn't. In the wide com- 
puter world Sun Microsystems 
developed Java and the lan- 
guage was eagerly taken up 
and used on websites. This 
kind of thing is an ideal situation 
but some operating systems 
have developed flavours of 
Java which differ radically from 
the original and some browsers 
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have actively worked against 
rivals versions. 

The suspicion exists (and it it 
not too unfeasible given the 
previous behaviour of this par- 
ty) that a similar ploy may be 
lurking at the heart of this offer 
and that is something that we 
would all do well to reject. The 
copyright for SMSQ/E is not up 
for sale here and the whole 
post of Registrar is more to do 
with maintaining cross system 
compatibility than protecting 
the small revenue that will 
come from the sale of copies 
of the system. 

All in all the overriding feeling | 
have got from all of this is a 
great admiration for Wolfgangs 
patience, perseverance and 
tact. Hats off to him | say for 
not throwing the whole thing 
back into the ring and going off 
for a long holiday somewhere 
that you don't have to wear an 
anorak. 


The Heart of the 


Matter 

| apologise for taking up so 
much space in this column with 
this subject but it is one which 
is Of great importance to all 
who use the QL or its offs- 
hoots. Whatever system your 
code runs on you need to be 
sure that as much software as 
possible is compatible with it. If 
too many applications start to 
fall over because of new de- 
velopments then users will 
eventually, have to abandon the 
system in favour of one which 
is Of more use or revert to the 
previous stable version. 

The Colour Drivers are a case 
in point here. Yes, they can en- 
hance your system, and you 
can use them from BASIC or by 
calls directly to the hardware 
but for the moment the Win- 
dow Manager has no access to 
the available colours. That may 
be about to change but the real 
point here is that the re- 


arrangement of the screen 
which was needed to get the 
colours working has meant that 
many older programs have a 
corrupted display and many are 
unusable. When we all started 
off using the QL we had so 
little memory that we had to 
reboot each time we wanted to 
use a different program but that 
is not the way it is today and it 
neither should it be. 

It is, however exactly what 
users who rely on Text 87, for 
instance, have to do if they 
want to run most of their stuff in 
high colour mode and still use 
the word processor. Again this 
Situation may change because 
Fred oussi, the program's 
author has offered to make 
some changes to the program 
if a change is made to the 
SMSQ/E high colour display 
driver All we need now is 
someone who is willing and 
able to make the changes. No 
small task | expect. 

You can go in and reprogram 
SMSQ/E, if you have the ability 
and change any part of the 
system to make it run better in 
some areas than in others but 
there will always be inconsis- 
tencies and conflicts and we 
really need the utmost co-ope- 
ration amongst the program- 
mers to make sure that shaving 
a few nanoseconds of a pro- 
cess or improving a benchmark 
is not the sole goal of such 
reprogramming. It may look 
good in the advert but what is 
the good of a fast car if it cra- 
shes whenever a passenger 
gets in? 


New Bits for Old 

In spite of all of the foregoing 
there is some cause for opti- 
mism. | am expecting to get a 
test version of a new keyboard 
interface, The Qeyboard, (what 
else?) soon although | have not 
yet either seen the item or 
know the prospective price. 


QL loday 


Q-CELT COMPUTING 


THE LARGEST SUPPLIER OF PURPOSE MADE QDOS CD-ROMS 


The Falconry, Glenmacnass, Glendalough, Co.Wicklow, Republic Of Ireland. 
Tel:(+#353)404-45319 Fax:(+353)404-45558 Mobile:(+353)86-8100090 
Email: gceltcomputing@hotmail.cem 


THE DILWYN JONES QL COLLECTION - All of the commercial and freeware software ever 
written by Dilwyn Jones, suffice to say this is excellent value and there are several programs here 
that no QL user should be without. REDUCED TO £15 !! 


THE QL EMULATORS CD - This is a collection of all known QL emulators for various formats, 
including the PC, Apple Mac, Unix/Linux, Atari and Amiga. It even includes a special version of 
Tony Tebbys Toolkit II and approximately 1,000 (Yes, one thousand!!) freeware and Public Domain 
QL programs. SPECIAL : JUST £5!! 


THE RELIGION CD-ROM - A huge collection of various texts, books and documentation with 
religious signifigance. All the major religions of the World are covered - origins, beliefs, etc. as well 
as sermons and parables. Priced at Just £10 


LINEDESIGN CLIPART CD - A full CD of the finest clipart ever produced for the QL. Over 600 
Megabytes of Data, and literally hundreds of files, crammed onto just one CD - perfect for designing 
that flyer or newsletter. Now just £10. 


INTERACTIVE FANTASY CD - The work of Phoebus Dokos, this is a great CD for the 
Adventure Gamer, and contains hundreds of INFOCOM adventure games,.. Lifetime updates are 
available FREE via email from Phoebus - ask for details. SPECIAL PRICE :- £10 (a percentage of 
all profits will be donated to charity) 


FAMOUS FACES CD -caricatures of the rich & famous in lineDesign format. £10. 


THE ZEXCEL SPECTRUM EMULATOR CD - A CD based on the popular ZX Spectrum 
Computer emulator - play all your old Spectrum favourites on your QL - thousands of Games are 
included, Utility Programs, Wp’s, Desktop Publishing etc. The latest version of ZeXcel for the QL is 
also included - months of fun for only £10!! 


WORLD OF Z88 CD — for the Cambridge Z88 Computer - almost 2,000 files, including MS-DOS 
and Windows Z88 Emulators, EPROM Images, Games, Utilities, the Z88 User Library, Sourcebook, 
etc. Just £8!! 


QOL DOCUMENTATION CD — A collection of doc’s for the QL on all available hardware and 
some hard to find information. Includes all miracle manuals! £10 


Above Prices do not include P&P — please add £1 per disk. We accept Cheques in Sterling made payable to 
“D.Branagh” and Major credit cards by prior arrangement — please email or phone for details. We also stock rare 
pieces of QL hardware & Software — Call us! 

Please allow up to 14 days for delivery. E&OE. 
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Dave Park does keep threaten- 
ing to put a picture up on his 
site so maybe that will be there 
by the time you read this. 

The new Qubide is also making 
progress and has, | gather, 
reached the pre-production 
stage so the hardware scene 
may well be set for a makeover. 
(Changing Roms - for my 
English readers} Rumour has it 
the that new IDE device will 
have a built-in Ethernet connec- 
tion so | should be able to con- 
nect the Aurora machine to the 
PC and that is an interesting 
prospect. 

Of course there is always the 
old bugbear of having to have 
proper software support al- 
though | had heard that Jona- 
than Dent's TCP/IP stack was 
already up to the task. (Again 
this is only hearsay and conjec- 
ture. | am sure that someone 
with more knowledge than me 
will put it right). | hope to have 
more first hand news of all of 
this after | return from the US 
show in June because Nasta - 
who has a hand in these pro- 
jects - will be on hand to enligh- 
ten me. 

A QL based Ethernet for the 
Q40 would be a useful item. | 
know you can do it from LINUX 
but, as far as | know there is 
not QDOS/SMSQ equivalent. In 
the general run of things the 
Aurora machine |s still hooked 
up but is very much a poor 
cousin to QPC2 and the Q40 
and is very underused. 

QPC2 tends to do most of my 
QL work with the Q40 running 
the magazine subscriptions and 
Q Branch Database. Before | 
start getting any (more) Q40 
hate mail this is purely down to 
the fact that the PC is usually 
already on and running all of 
the internet tasks, moving my 
live music tapes onto CD etc. 
The other advantage of QPC2, 
of course, is the ability to run in 
QL Colour mode and run Text 
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87 which the Q40 cannot do 
without being limited to 512 x 
256. But | have mentioned this 
before - | should not go getting 
too recursive here. 


Duncan Says 

And talking of systems and the 
Q40.... 

At the recent Manchester AGM 
| chatting fo the, very know- 
ledgable, Duncan Neithercut 
and | were chatting about pro- 
blems with compatibility He 
said that he had just bought a 
Q60. We talked about the Pro- 
WesS and QLIB problems and | 
said that | had lost a lot of heart 
in the Q40 because these pro- 
blems were never really ad- 
dressed - just denied. | got an 
email from Duncan which | 
reproduce here in full. 


"Hello, | think you have men- 
tioned to me you have experi- 
enced the same difficulty as | 
have in getting ProWesS to 
run reliably on the Q40 with 
the patched version — of 
SMSQ/E 298 or 299 and 
especially when QLib is run. 

| may have a solution that | 
have come across while trans- 
ferring things over to the Q60 | 
have recently acquired. The 
Q60 support disks came with 
CacheModes_rext which — is 
from Mark Swift and is on his 
web site. It gives more control 
over the caches and gives 
Slightly different results from 
the SMSQ/E cache command ! 
have used previously. This 
needs to be LRESPRed at the 
Start of the boot file and the 
WRITETHROUGH — command 
used at the start of the boot 
fle | also use the SMSQ/E 
cache_off command as well. 
At the end of the boot 
Cache_on and either 
COPYBACK or 
WRITETHROUGH is used 
again to get some speed. If 
COPYBACK is enabled QLIB 


and some QLiberated pro- 
grams still run into trouble but 
with WRITETHROUGH the Qli- 
berated programs | have seem 
OK. QLib_obj itself does not 
reliably run until the configura- 
tion values for stak and heap 
are X4 increased beyond their 
default values. 

Once that is done and WRITE- 
THROUGH enabled | can com- 
pile SBASIC up to 80k and 
print from line design on the 
Q40 or Q60. 

If the above is coherent it may 
be of use 

Duncan’ 


| have made a brief attempt at 
testing the concepts involved 
here but it is not as thoroughly 
tested as | would like. | will try 
to report on this more in the 
next issue. One thing that does 
occur to me is the fact that 
having to load and manipulate 
cache software is not a satis- 
factory solution - especially 
given the foregoing comments 
on user abilities. It is absolutely 
imperative that the system is of 
use to someone who does not 
want to concern himself with 
these things too deeply. 

We can dismiss these people if 
we like and say that the system 
is not for the faint hearted and 
those whose programming 
Skills are not up to the task of 
keeping the system functioning 
- and then we will have so few 
users that it will not be worth- 
while to continue. That way 
Linux lies. 


Q40isms again 

It would also seem that the ver- 
sion of the Q40 being sold by 
D&D systems is not the same 
as the one that Q Branch was 
selling. Apparently this is the 
Q40i and the Q40, as such, is 
no longer supported’. Nice of 
them to tell us, eh? | have not 
had any details of the diffe- 
rence between the two. ver- 
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sions (except that the Q40ji 
supports 128Mb RAM) but De- 
rek hinted that | should get a 
Q60 and the problems | had 
would go away. | think we need 
some more details here if the 
user is not to feel he is being 
kept deliberately in the dark. 

lf it was felt necessary to 
change more than just the RAM 
capacity on the Q40 then what 
was changed, why and, more 
to the point | would say, is there 
any way that those of us who 
have a Q40 can upgrade it to a 
Q40i without having to buy a 
new board? Time to ‘fress up’ 


QUYS. 


Headhunters 

There seem to be a lot of col 
lectors around these days. A 
few years ago it was hard to 
give a QL away and | know for 
a fact that several of the old QL 
User Guides went straight to 
the tio after a QL workshop 
when no-one wanted to buy or 
even have them from free from 
a Bring and Buy sale. | have 
about 10 standard QLs_ in 
working order here and | have 
passed some of them on to 
users who have either stripped 
theirs down in the past to build 
a new, cased, system or got rid 
of them when they moved onto 
a PC (with or without a QXL/ 
QPC emulator). 

Collectors tempt you into offe- 
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ring the QLs for 
silly prices but, 
on the whole, 
they just want 
to put the 
things into glass 
cases and not 
get them up and 
running. One 
person who 
contacted me 
wanted some 
microdrive software so he 
could run it up but admitted 
that, after he had had it going, 
he would put it into the display 
case and that would be it. 

Someone did tell me once how 
many QLs were made (| instant- 
ly forgot it again) and it was a 
pretty impressive number Now 
there are not really so many of 
the original boxes around. 
When | stripped two down and 
built them into cases | just 
threw the odd bits away and | 
suspect there were many 
others who did the same thing. 
For a while there was not a 
standard QL to be seen at Q 
Branch Towers. | was very 
pleased when Jamie Muggle- 
ton, who runs the office for Ju- 
die Tzukie {a singer and song- 
writer of some excellence) told 
me that he had a complete and 
hardly used QL in an original 
box in the office. This machine 
is now the one that | use to 
make the cover disks on. | have 
accumulated a few more since. 


OBITUARY 


Anthony Boddrell has informed us 
of the death of Mr JHS Neilson of 


Stanion, Kettering, England. We 
would like to extend our sympa- 
thies to Mr Neilson's family. 


Many of us are collectors too 
of a kind. Over the years of run- 
ning Q Branch | have managed 
to accumulate all of the issues 
of QL World, QL User IQLR etc 
and have them in the original 
binders too. | know that Urs 
Konig has managed to collect 
an impressive array of QLs of 
various builds. However | think 
that we are all reading this and 
interested in the QLs_ history 
and future because we like 
what it can do and we like how 
it does it and that is entirely 
how it should be. 


Across the Pond 

As | finish this | am preparing 
for the next US show, In fact 
the first people to read these 
words may be the attendees of 
the Washington DC show 
There should be some interest 
there for Jim Hunkins QDT pro- 
grams and Nasta’s projects. | 
hope to be able to give some 
insight into this and other things 
in the next issue. 


These two screen dumps were omitted from George Gwilt’s TurboPTR and QMenu article in QL Today 


Volume 6 Issue 5. 


aes Direc 
Print the directorys 


Choos 


gf Press ESC for ol (0 


OL Meeting - (NL) Eindhoven 


Saturday, 22nd of June, 10:00 to 16:00 
Pleincollege St. Joris, Roostenlaan 296 


The usual range of dealers will be there, eg QBranch, TF Services and J-M-S 


Quanta workshop - (GB) Byfleet 


Sunday, 22nd of September 
Same venue as every year: 
ane Bysleet manage Hall. 


German OL Show - (D) Beh ieaien 


Two-Day Event, Sat./Sun, 5th/6th October 


Same venue as last year: Hotel Schwabenwirt 
Koenigsseer Str. 1, D-83471 Berchtesgaden 
(phone +49-8652-2011, fax -1706, no email) 


How to get there: Only 150m from the big railway-/bus-station in Berchtesgaden: You cross the street and the 
bridge to Koenigssee (not Schoenau, it leads to the graves!) and then see at the left side the yellow hotel with 
some green trees around in a nice beer-garden and a good cinema inside. Very easy to find! Parking near the 
hotel. 


Further information via F.Oertel.BGD@t-online.de or +49-8652-94871-2 or -3. or +49-170 40 65 272 mobile 
The meeting starts on friday afternoon, 610.2001 and ends on sunday, 8.10.2001 in the morning (departure, 
sightseeing). The main-event is on Saturday, 7.102002. QL-enthusiasts, | hope, will come from around Germany 
(especially Munich), Great Britain, Austria (esp. Vienna, Salzburg), Netherlands and even USA. 

For those who like to stay in this wonderful region, here are some hints, for getting rooms too: 
www.berchtesgadener-land.com or www.berchtesgaden-last-minute.de Of www.salzburg.com 


We have a lot of proposals for nice trios and wanderings - also for the whole family: 
In Berchtesgaden there is a fantastic adventure-swimmingpool, two cinemas, a famous saltmine, castles, 
fortresses, the national park, the historic Obersalzberg, in former times Hitlers mountain (see the bunkers and 
a museum), busses and elevators to high mountains, lifting you from 550 m to over 2500m high. Please 
remember, that you should have good boots and clothing for such excursions into the higher mountains. In 
harvest there is often brilliant sight far into the alps!!! Take a trip with the ship across the famous kings lake 
(Koenigssee) with clear water, 200m deep or go to a trip with a mountainbike. See the oldest pipeline, made 
from wood, for the salty water or go to the salt-museum in the near Bad Reichenhall. It's great! Make your 
trios by bus or car 

Nearby there is Salzburg, a fine historic town with a big fortress, shopping-streets, museums, a Z00, .. 


Driving directions in the next issue. 


